[BACK]Return to lonproblemstatistics.pm CVS log [TXT] [DIR] Up to [LON-CAPA] / loncom / interface / statistics

Diff for /loncom/interface/statistics/lonproblemstatistics.pm between versions 1.76 and 1.122.2.2

version 1.76, 2004/03/29 19:41:24 version 1.122.2.2, 2013/12/30 14:05:21
Line 50  Excel files, and plots. Line 50  Excel files, and plots.
 package Apache::lonproblemstatistics;  package Apache::lonproblemstatistics;
   
 use strict;  use strict;
 use Apache::lonnet();  use Apache::lonnet;
 use Apache::loncommon();  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 Apache::lonlocal;
 use Spreadsheet::WriteExcel;  use Spreadsheet::WriteExcel;
 use Apache::lonstathelpers();  use Apache::lonstathelpers();
 use Time::HiRes;  use Time::HiRes;
   use LONCAPA;
    
   
 my @StatsArray;  my @StatsArray;
   my %SeqStat;    # keys are symbs, values are hash refs
   
 ##  ##
 ## Localization notes:  ## Localization notes:
Line 69  my @StatsArray; Line 73  my @StatsArray;
 ## header for plots created with Graph.pm, both of which more than likely do  ## header for plots created with Graph.pm, both of which more than likely do
 ## not support localization.  ## not support localization.
 ##  ##
   ## Additional Notes:
   ## Localization can be done and is done before passing the phrases
   ## to the output.
   ## This might conflict with special characters, e.g. German Umlaute or
   ## chinese characters. Do not use such characters in this case.
   ## If this failed, consider that the sequence and folder names
   ## are also passed to the output and would fail the same way.
   ##
   #
   #
   ##
   ## 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.  Passed through &mt().
   ## 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 = (  my @Fields = (
            { name => 'problem_num',             { name => 'problem_num',
              title => 'P#',               title => 'P#',
              align => 'right',               align => 'right',
              color => '#FFFFE6',               color => '#FFFFE6',
              selectable => 'no',               selectable => 'no',
              selected => 'yes',               defaultselected => 'yes',
            },             },
            { name   => 'container',             { name   => 'container',
              title  => 'Sequence or Folder',               title  => 'Sequence or Folder',
Line 83  my @Fields = ( Line 124  my @Fields = (
              color  => '#FFFFE6',               color  => '#FFFFE6',
              sortable => 'yes',               sortable => 'yes',
              selectable => 'no',               selectable => 'no',
              selected => 'yes',               defaultselected => 'yes',
            },             },
            { name   => 'title',             { name   => 'title',
              title  => 'Title',               title  => 'Title',
              align  => 'left',               align  => 'left',
              color  => '#FFFFE6',               color  => '#FFFFE6',
              special  => 'link',               special  => 'link',
              sortable => 'yes',                sortable => 'yes',
              selectable => 'no',               selectable => 'no',
              selected => 'yes',               defaultselected => 'yes',
            },             },
            { name   => 'part',              { name   => 'part',
              title  => 'Part',               title  => 'Part',
              align  => 'left',               align  => 'left',
              color  => '#FFFFE6',               color  => '#FFFFE6',
              selectable => 'no',               selectable => 'no',
              selected => 'yes',               defaultselected => 'yes',
            },             },
            { name   => 'num_students',             { name   => 'num_students',
              title  => '#Stdnts',               title  => '#Stdnts',
Line 110  my @Fields = ( Line 151  my @Fields = (
              graphable => 'yes',               graphable => 'yes',
              long_title => 'Number of Students Attempting Problem',               long_title => 'Number of Students Attempting Problem',
              selectable => 'yes',               selectable => 'yes',
              selected => 'yes',               defaultselected => 'yes',
            },             },
            { name   => 'tries',             { name   => 'tries',
              title  => 'Tries',               title  => 'Tries',
Line 121  my @Fields = ( Line 162  my @Fields = (
              graphable => 'yes',               graphable => 'yes',
              long_title => 'Total Number of Tries',               long_title => 'Total Number of Tries',
              selectable => 'yes',               selectable => 'yes',
              selected => 'yes',               defaultselected => 'yes',
            },             },
            { name   => 'max_tries',             { name   => 'max_tries',
              title  => 'Max Tries',               title  => 'Max Tries',
Line 132  my @Fields = ( Line 173  my @Fields = (
              graphable => 'yes',               graphable => 'yes',
              long_title => 'Maximum Number of Tries',               long_title => 'Maximum Number of Tries',
              selectable => 'yes',               selectable => 'yes',
              selected => 'yes',               defaultselected => 'yes',
            },             },
            { name   => 'min_tries',             { name   => 'min_tries',
              title  => 'Min Tries',               title  => 'Min Tries',
Line 143  my @Fields = ( Line 184  my @Fields = (
              graphable => 'yes',               graphable => 'yes',
              long_title => 'Minumum Number of Tries',               long_title => 'Minumum Number of Tries',
              selectable => 'yes',               selectable => 'yes',
              selected => 'yes',               defaultselected => 'yes',
            },             },
            { name   => 'mean_tries',             { name   => 'mean_tries',
              title  => 'Mean Tries',               title  => 'Mean Tries',
Line 154  my @Fields = ( Line 195  my @Fields = (
              graphable => 'yes',               graphable => 'yes',
              long_title => 'Average Number of Tries',               long_title => 'Average Number of Tries',
              selectable => 'yes',               selectable => 'yes',
              selected => 'yes',               defaultselected => 'yes',
            },             },
            { name   => 'std_tries',             { name   => 'std_tries',
              title  => 'S.D. tries',               title  => 'S.D. tries',
Line 165  my @Fields = ( Line 206  my @Fields = (
              graphable => 'yes',               graphable => 'yes',
              long_title => 'Standard Deviation of Number of Tries',               long_title => 'Standard Deviation of Number of Tries',
              selectable => 'yes',               selectable => 'yes',
              selected => 'yes',               defaultselected => 'yes',
            },             },
            { name   => 'skew_tries',             { name   => 'skew_tries',
              title  => 'Skew Tries',               title  => 'Skew Tries',
Line 176  my @Fields = ( Line 217  my @Fields = (
              graphable => 'yes',               graphable => 'yes',
              long_title => 'Skew of Number of Tries',               long_title => 'Skew of Number of Tries',
              selectable => 'yes',               selectable => 'yes',
              selected => 'no',               defaultselected => 'no',
            },             },
            { name   => 'num_solved',             { name   => 'num_solved',
              title  => '#YES',               title  => '#YES',
Line 186  my @Fields = ( Line 227  my @Fields = (
              sortable  => 'yes',               sortable  => 'yes',
              graphable => 'yes',               graphable => 'yes',
              long_title => 'Number of Students able to Solve',               long_title => 'Number of Students able to Solve',
              selectable => 'no',               selectable => 'yes',
              selected => 'yes',               defaultselected => 'yes',
            },             },
            { name   => 'num_override',             { name   => 'num_override',
              title  => '#yes',               title  => '#yes',
Line 198  my @Fields = ( Line 239  my @Fields = (
              graphable => 'yes',               graphable => 'yes',
              long_title => 'Number of Students given Override',               long_title => 'Number of Students given Override',
              selectable => 'yes',               selectable => 'yes',
              selected => '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',             { name   => 'num_wrong',
              title  => '#Wrng',               title  => '#Wrng',
Line 207  my @Fields = ( Line 259  my @Fields = (
              format => '%4.1f',               format => '%4.1f',
              sortable  => 'yes',               sortable  => 'yes',
              graphable => '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',               long_title => 'Percent of students whose final answer is wrong',
              selectable => 'yes',               selectable => 'yes',
              selected => 'yes',               defaultselected => 'yes',
            },             },
            { name   => 'deg_of_diff',             { name   => 'deg_of_diff',
              title  => 'DoDiff',               title  => 'DoDiff',
Line 219  my @Fields = ( Line 282  my @Fields = (
              sortable  => 'yes',               sortable  => 'yes',
              graphable => 'yes',               graphable => 'yes',
              long_title => 'Degree of Difficulty'.               long_title => 'Degree of Difficulty'.
                            '[ 1 - ((#YES+#yes) / Tries) ]',                             ' ~[ 1 - ((#YES+#yes) / Tries) ~]',
              selectable => 'yes',               selectable => 'yes',
              selected => 'yes',               defaultselected => 'yes',
            },             },
            { name   => 'deg_of_disc',             { name   => 'deg_of_disc',
              title  => 'DoDisc',               title  => 'DoDisc',
Line 232  my @Fields = ( Line 295  my @Fields = (
              graphable => 'yes',               graphable => 'yes',
              long_title => 'Degree of Discrimination',               long_title => 'Degree of Discrimination',
              selectable => 'yes',               selectable => 'yes',
              selected => 'no',               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',
            },             },
 );  );
   
Line 241  my %SelectedFields; Line 526  my %SelectedFields;
 sub parse_field_selection {  sub parse_field_selection {
     #      #
     # Pull out the defaults      # Pull out the defaults
     if (! defined($ENV{'form.fieldselections'})) {      if (! defined($env{'form.fieldselections'})) {
         $ENV{'form.fieldselections'} = [];          $env{'form.fieldselections'} = [];
         foreach my $field (@Fields) {          foreach my $field (@Fields) {
             next if ($field->{'selectable'} ne 'yes');              next if ($field->{'selectable'} ne 'yes');
             if ($field->{'selected'} eq 'yes') {              if ($field->{'defaultselected'} eq 'yes') {
                 push(@{$ENV{'form.fieldselections'}},$field->{'name'});                  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...      # This should not happen, but in case it does...
     if (ref($ENV{'form.fieldselections'}) ne 'ARRAY') {      if (ref($env{'form.fieldselections'}) ne 'ARRAY') {
         $ENV{'form.fieldselections'} = [$ENV{'form.fieldselections'}];          $env{'form.fieldselections'} = [$env{'form.fieldselections'}];
     }      }
     #      #
     # Set the field data and the selected fields (for easier checking)      # Set the field data and the selected fields (for easier checking)
     undef(%SelectedFields);      undef(%SelectedFields);
     foreach my $field (@Fields) {      foreach my $field (@Fields) {
         next if ($field->{'selectable'} ne 'yes');          if ($field->{'selectable'} ne 'yes') {
         $field->{'selected'} = 'no';              $field->{'selected'} = 'yes';
         foreach my $selection (@{$ENV{'form.fieldselections'}}) {          } 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') {              if ($selection eq $field->{'name'} || $selection eq 'all') {
                 $field->{'selected'} = 'yes';                  $field->{'selected'} = 'yes';
                 $SelectedFields{$field->{'name'}}++;                  $SelectedFields{$field->{'name'}}++;
             }              }
         }          }
     }      }
       #
       # Always show all the sequence statistics (for now)
       foreach my $field (@SeqFields) {
           $field->{'selected'} = 'yes';
       }
     return;      return;
 }  }
   
 sub field_selection_input {  sub field_selection_input {
     my $Str = '<select name="fieldselections" multiple size="5">'."\n";      my $Str = '<select name="fieldselections" multiple="multiple" size="5">'."\n";
     $Str .= '<option value="all">all</option>'."\n";      $Str .= '<option value="all">all</option>'."\n";
     foreach my $field (@Fields) {      foreach my $field (@Fields) {
         next if ($field->{'selectable'} ne 'yes');          next if ($field->{'selectable'} ne 'yes');
Line 300  select sections, maps, and output. Line 613  select sections, maps, and output.
 ###############################################  ###############################################
 ###############################################  ###############################################
 sub CreateInterface {  sub CreateInterface {
       my ($r) = @_;
       #
     &parse_field_selection();      &parse_field_selection();
       #
     my $Str = '';      my $Str = '';
     $Str .= &Apache::lonhtmlcommon::breadcrumbs      $Str .= '<p>';
         (undef,'Overall Problem Statistics','Statistics_Overall_Key');      $Str .= &Apache::loncommon::start_data_table();
     $Str .= '<table cellspacing="5">'."\n";      $Str .= &Apache::loncommon::start_data_table_header_row();
     $Str .= '<tr>';      $Str .= '<th>'.&mt('Sections').'</th>';
     $Str .= '<td align="center"><b>'.&mt('Sections').'</b></td>';      $Str .= '<th>'.&mt('Groups').'</th>';
     $Str .= '<td align="center"><b>'.&mt('Enrollment Status').'</b></td>';      $Str .= '<th>'.&mt('Access Status').'</th>';
     $Str .= '<td align="center"><b>'.&mt('Sequences and Folders').'</b></td>';      $Str .= '<th>'.&mt('Sequences and Folders').'</th>';
     $Str .= '<td align="center"><b>'.&mt('Statistics').'</b></td>';      $Str .= '<th>'.&mt('Statistics').'</th>';
     $Str .= '<td rowspan="2">'.      $Str .= '<th>'.&mt('Plot Graph').'</th>';
         &Apache::lonstathelpers::limit_by_time_form().'</td>';      $Str .= '<th>'.&mt('Time Period').'</th>';
     $Str .= '</tr>'."\n";      $Str .= &Apache::loncommon::end_data_table_header_row();
     #      #
     $Str .= '<tr><td align="center">'."\n";      $Str .= &Apache::loncommon::start_data_table_row();
       $Str .= '<td align="center" valign="top">'."\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" valign="top">';
       $Str .= &Apache::lonstatistics::GroupSelect('Group','multiple',5);
       $Str .= '</td><td align="center" valign="top">';
     $Str .= &Apache::lonhtmlcommon::StatusOptions(undef,undef,5);      $Str .= &Apache::lonhtmlcommon::StatusOptions(undef,undef,5);
     $Str .= '</td><td align="center">';      $Str .= '</td><td align="center" valign="top">';
       #
       $Str .= &Apache::lonstatistics::map_select('Maps','multiple,all',5);
       $Str .= '</td><td align="center" valign="top">';
       $Str .= &field_selection_input();
       $Str .= '</td><td align="center" valign="top">';
       $Str .= &plot_dropdown();
       $Str .= '</td>'."\n";
       $Str .= '</td><td align="center" valign="top">';
       $Str .= &Apache::lonstathelpers::limit_by_time_form();
       $Str .= '</td>'."\n";
       $Str .=  &Apache::loncommon::end_data_table_row();
       $Str .= &Apache::loncommon::end_data_table();
     #      #
     my $only_seq_with_assessments = sub {       $Str .= '</p>';
         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="'.      $Str .= '<input type="submit" name="GenerateStatistics" value="'.
         &mt('Generate Statistics').'" />';          &mt('Generate Statistics').'" />';
     $Str .= '&nbsp;'x5;      $Str .= ('&nbsp;'x10);
     $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;      return $Str;
 }  }
   
Line 362  Main interface to problem statistics. Line 672  Main interface to problem statistics.
   
 ###############################################  ###############################################
 ###############################################  ###############################################
   my $navmap;
   my @sequences;
   
   sub clean_up {
       undef($navmap);
       undef(@sequences);
   }
   
 sub BuildProblemStatisticsPage {  sub BuildProblemStatisticsPage {
     my ($r,$c)=@_;      my ($r,$c)=@_;
       undef($navmap);
       undef(@sequences);
     #      #
     my %Saveable_Parameters = ('Status' => 'scalar',      my %Saveable_Parameters = ('Status' => 'scalar',
                                'statsoutputmode' => 'scalar',                                 'statsoutputmode' => 'scalar',
                                'Section' => 'array',                                 'Section' => 'array',
                                  'Groups' => 'array',
                                'StudentData' => 'array',                                 'StudentData' => 'array',
                                'Maps' => 'array');                                 'Maps' => 'array',
                                  'fieldselections'=> 'array');
     &Apache::loncommon::store_course_settings('statistics',      &Apache::loncommon::store_course_settings('statistics',
                                               \%Saveable_Parameters);                                                \%Saveable_Parameters);
     &Apache::loncommon::restore_course_settings('statistics',      &Apache::loncommon::restore_course_settings('statistics',
Line 379  sub BuildProblemStatisticsPage { Line 701  sub BuildProblemStatisticsPage {
     #      #
     # Clear the package variables      # Clear the package variables
     undef(@StatsArray);      undef(@StatsArray);
       undef(%SeqStat);
     #      #
     # Finally let the user know we are here      # Finally let the user know we are here
     my $interface = &CreateInterface();      $r->print(&Apache::lonhtmlcommon::breadcrumbs('Overall Problem Statistics',
                                                   'Statistics_Overall_Key'));
   
       my $interface = &CreateInterface($r);
     $r->print($interface);      $r->print($interface);
     $r->print('<input type="hidden" name="sortby" value="'.$ENV{'form.sortby'}.      $r->print('<input type="hidden" name="sortby" value="'.$env{'form.sortby'}.
               '" />');                '" />');
     #      #
     if (! exists($ENV{'form.statsfirstcall'})) {      my @CacheButtonHTML =
         $r->print('<input type="hidden" name="statsfirstcall" value="yes" />');          &Apache::lonstathelpers::manage_caches($r,'Statistics','stats_status');
         $r->print('<h3>'.      my $Str;
       foreach my $html (@CacheButtonHTML) {
           $Str.=$html.('&nbsp;'x5);
       }
       #
       $r->print($Str);
       if (! exists($env{'form.firstrun'})) {
           $r->print('<p class="LC_info"><b>'.
                   &mt('Press "Generate Statistics" when you are ready.').                    &mt('Press "Generate Statistics" when you are ready.').
                   '</h3><p>'.                    '</b></p>'.
                     '<p class="LC_info">'.
                   &mt('It may take some time to update the student data '.                    &mt('It may take some time to update the student data '.
                       'for the first analysis.  Future analysis this session '.                        'for the first analysis. Future analysis this session '.
                       ' will not have this delay.').                        'will not have this delay.').
                   '</p>');                    '</p>');
    &clean_up();
         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" />');  
     }      }
     $r->rflush();      $r->rflush();
     #      #
Line 410  sub BuildProblemStatisticsPage { Line 738  sub BuildProblemStatisticsPage {
     # it does not slow things down noticably.      # it does not slow things down noticably.
     &Apache::loncoursedata::populate_weight_table();      &Apache::loncoursedata::populate_weight_table();
     #      #
     if (exists($ENV{'form.Excel'})) {      ($navmap,@sequences) =
           &Apache::lonstatistics::selected_sequences_with_assessments();
       if (! ref($navmap)) {
           $r->print('<div class="LC_error">'.&mt('A course-wide error occurred.').'</div>'.
                     '<h3>'.$navmap.'</h3>');
    &clean_up();
           return;
       }
       if (exists($env{'form.Excel'})) {
           $r->print('<p>'.
                     &Apache::lonstatistics::section_and_enrollment_description().
                     '</p>');
         &Excel_output($r);          &Excel_output($r);
     } else {      } else {
           $r->print('<input type="submit" name="Excel" value="'.
                     &mt('Produce Excel Output').'" />'.'&nbsp;'x5);
           $r->rflush();
           $r->print('<p>'.
                     &Apache::lonstatistics::section_and_enrollment_description().
                     '</p>');
         my $count = 0;          my $count = 0;
         foreach my $seq (&Apache::lonstatistics::Sequences_with_Assess()) {          foreach my $seq (@sequences) {
             $count += $seq->{'num_assess'};              my @resources =
                   &Apache::lonstathelpers::get_resources($navmap,$seq);
               $count += scalar(@resources);
         }          }
         if ($count > 10) {          if ($count > 10) {
             $r->print('<h2>'.              $r->print('<p>'.
                       &mt('Compiling statistics for [_1] problems',$count).                        &mt('Compiling statistics for [quant,_1,problem]',$count).
                       '</h2>');                        '</p>');
             if ($count > 30) {              if ($count > 30) {
                 $r->print('<h3>'.&mt('This will take some time.').'</h3>');                  $r->print('<p class="LC_info">'.&mt('This will take some time.').'</p>');
             }              }
             $r->rflush();              $r->rflush();
         }          }
         #          #
         my $sortby = $ENV{'form.sortby'};          my $sortby = $env{'form.sortby'};
         $sortby = 'container' if (! defined($sortby) || $sortby =~ /^\s*$/);          $sortby = 'container' if (! defined($sortby) || $sortby =~ /^\s*$/);
         my $plot = $ENV{'form.plot'};          my $plot = $env{'form.plot'};
         if ($plot eq '' || $plot eq 'none') {          if ($plot eq '' || $plot eq 'none') {
             undef($plot);              undef($plot);
         }          }
         if ($sortby eq 'container' && ! defined($plot)) {          if ($sortby eq 'container' && ! defined($plot)) {
               &output_sequence_statistics($r);
             &output_html_by_sequence($r);              &output_html_by_sequence($r);
         } else {          } else {
             if (defined($plot)) {              if (defined($plot)) {
                 &make_plot($r,$plot);                  &make_plot($r,$plot);
             }              }
             &output_html_stats($r);              &output_html_stats($r);
               &output_sequence_statistics($r);
         }          }
     }      }
       &clean_up();
     return;      return;
 }  }
   
   sub output_sequence_statistics {
       my ($r) = @_;
       my $c=$r->connection();
       $r->print('<h2>'.&mt('Sequence Statistics').
         &Apache::loncommon::help_open_topic('Statistics_Sequence').
         '</h2>');
       $r->print(&Apache::loncommon::start_data_table().&Apache::loncommon::start_data_table_header_row());
       $r->print(&sequence_html_header());
       $r->print(&Apache::loncommon::end_data_table_header_row());
       foreach my $seq (@sequences) {
           last if ($c->aborted);
           &compute_sequence_statistics($seq);
           $r->print(&sequence_html_output($seq));
       }
       $r->print(&Apache::loncommon::end_data_table());
       $r->rflush();
       return;
   }
   
   
 ##########################################################  ##########################################################
 ##########################################################  ##########################################################
 ##  ##
Line 455  sub BuildProblemStatisticsPage { Line 825  sub BuildProblemStatisticsPage {
 sub output_html_by_sequence {  sub output_html_by_sequence {
     my ($r) = @_;      my ($r) = @_;
     my $c = $r->connection();      my $c = $r->connection();
     $r->print(&html_preamble());      $r->print('<br>'.&html_preamble());
     #      #
     foreach my $seq (&Apache::lonstatistics::Sequences_with_Assess()) {      foreach my $seq (@sequences) {
         last if ($c->aborted);          last if ($c->aborted);
         next if ($seq->{'num_assess'} < 1);          $r->print("<h3>".$seq->compTitle."</h3>".
         $r->print("<h3>".$seq->{'title'}."</h3>".                      &Apache::loncommon::start_data_table().
                   '<table border="0"><tr><td bgcolor="#777777">'."\n".                      &Apache::loncommon::start_data_table_header_row().
                   '<table border="0" cellpadding="3">'."\n".                      &statistics_table_header('no container').
                   '<tr bgcolor="#FFFFE6">'.                      &Apache::loncommon::end_data_table_header_row()."\n");
                   &statistics_table_header('no container')."</tr>\n");  
         my @Data = &compute_statistics_on_sequence($seq);          my @Data = &compute_statistics_on_sequence($seq);
         foreach my $data (@Data) {          foreach my $data (@Data) {
             $r->print('<tr>'.&statistics_html_table_data($data,              $r->print(&Apache::loncommon::start_data_table_row().
                                                          'no container').                      &statistics_html_table_data($data,'no container').
                       "</tr>\n");                      &Apache::loncommon::end_data_table_row()."\n");
         }          }
         $r->print('</table>'."\n".'</table>'."\n");          $r->print(&Apache::loncommon::end_data_table()."\n");
         $r->rflush();          $r->rflush();
     }      }
     return;      return;
Line 481  sub output_html_stats { Line 850  sub output_html_stats {
     my ($r)=@_;      my ($r)=@_;
     &compute_all_statistics($r);      &compute_all_statistics($r);
     $r->print(&html_preamble());      $r->print(&html_preamble());
     &sort_data($ENV{'form.sortby'});      &sort_data($env{'form.sortby'});
     #      #
     my $count=0;      my $count=0;
     foreach my $data (@StatsArray) {      foreach my $data (@StatsArray) {
         if ($count++ % 50 == 0) {          if ($count++ % 50 == 0) {
             $r->print("</table>\n</table>\n");              $r->print(&Apache::loncommon::end_data_table());
             $r->print('<table border="0"><tr><td bgcolor="#777777">'."\n".              $r->print(&Apache::loncommon::start_data_table().
                       '<table border="0" cellpadding="3">'."\n".                      &Apache::loncommon::start_data_table_row().
                       '<tr bgcolor="#FFFFE6">'.                      &statistics_table_header().
                       '<tr bgcolor="#FFFFE6">'.                      &Apache::loncommon::end_data_table_row());
                       &statistics_table_header().          }
                       "</tr>\n");          $r->print(&Apache::loncommon::start_data_table_row().
         }                  &statistics_html_table_data($data).
         $r->print('<tr>'.&statistics_html_table_data($data)."</tr>\n");                  &Apache::loncommon::end_data_table_row());
     }      }
     $r->print("</table>\n</table>\n");      $r->print(&Apache::loncommon::end_data_table_row());
     return;      return;
 }  }
   
 sub html_preamble {  sub html_preamble {
     my $Str='';      my $Str='';
     $Str .= "<h2>".      $Str .= "<h2>".
         $ENV{'course.'.$ENV{'request.course.id'}.'.description'}.          $env{'course.'.$env{'request.course.id'}.'.description'}.
         "</h2>\n";          "</h2>\n";
     my ($starttime,$endtime) = &Apache::lonstathelpers::get_time_limits();      my ($starttime,$endtime) = &Apache::lonstathelpers::get_time_limits();
     if (defined($starttime) || defined($endtime)) {      if (defined($starttime) || defined($endtime)) {
Line 513  sub html_preamble { Line 882  sub html_preamble {
                            &Apache::lonlocal::locallocaltime($endtime)                             &Apache::lonlocal::locallocaltime($endtime)
                            ).'</h3>';                             ).'</h3>';
     }      }
     $Str .= "<h3>".&mt('Compiled on [_1]',      $Str .= "<p>".&mt('Compiled on [_1]',
                        &Apache::lonlocal::locallocaltime(time))."</h3>";                         &Apache::lonlocal::locallocaltime(time))."</p>";
     return $Str;      return $Str;
 }  }
   
Line 532  sub statistics_html_table_data { Line 901  sub statistics_html_table_data {
     foreach my $field (@Fields) {      foreach my $field (@Fields) {
         next if ($options =~ /no $field->{'name'}/);          next if ($options =~ /no $field->{'name'}/);
         next if ($field->{'selected'} ne 'yes');          next if ($field->{'selected'} ne 'yes');
         $row .= '<td bgcolor="'.$field->{'color'}.'"';          $row .= '<td style="background-color:'.$field->{'color'}.'"';
         if (exists($field->{'align'})) {          if (exists($field->{'align'})) {
             $row .= ' align="'.$field->{'align'}.'"';              $row .= ' align="'.$field->{'align'}.'"';
             }              }
Line 540  sub statistics_html_table_data { Line 909  sub statistics_html_table_data {
         if (exists($field->{'special'}) && $field->{'special'} eq 'link') {          if (exists($field->{'special'}) && $field->{'special'} eq 'link') {
             $row .= '<a href="'.$data->{$field->{'name'}.'.link'}.'">';              $row .= '<a href="'.$data->{$field->{'name'}.'.link'}.'">';
         }          }
         if (exists($field->{'format'})) {          if (exists($field->{'format'}) && $data->{$field->{'name'}} !~ /[A-Z]/i) {
             $row .= sprintf($field->{'format'},$data->{$field->{'name'}});              $row .= sprintf($field->{'format'},$data->{$field->{'name'}});
         } else {          } else {
             $row .= $data->{$field->{'name'}};              $row .= $data->{$field->{'name'}};
Line 583  sub statistics_table_header { Line 952  sub statistics_table_header {
     return $header_row;      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;
   }
   
 ####################################################  ####################################################
 ####################################################  ####################################################
 ##  ##
Line 593  sub statistics_table_header { Line 996  sub statistics_table_header {
 sub make_plot {  sub make_plot {
     my ($r,$plot) = @_;      my ($r,$plot) = @_;
     &compute_all_statistics($r);      &compute_all_statistics($r);
     &sort_data($ENV{'form.sortby'});      &sort_data($env{'form.sortby'});
     if ($plot eq 'degrees') {      if ($plot eq 'degrees') {
         &degrees_plot($r);          &degrees_plot($r);
     } elsif ($plot eq 'tries statistics') {      } elsif ($plot eq 'tries statistics') {
Line 610  sub make_single_stat_plot { Line 1013  sub make_single_stat_plot {
     my $title; my $yaxis;      my $title; my $yaxis;
     foreach my $field (@Fields) {      foreach my $field (@Fields) {
         next if ($field->{'name'} ne $datafield);          next if ($field->{'name'} ne $datafield);
         $title = $field->{'long_title'};          $title = &mt($field->{'long_title'});
         $yaxis = $field->{'title'};          $yaxis = &mt($field->{'title'});
         last;          last;
     }      }
     if ($title eq '' || $yaxis eq '') {      if ($title eq '' || $yaxis eq '') {
         # datafield is something we do not know enough about to plot          # datafield is something we do not know enough about to plot
         $r->print('<h3>'.          $r->print('<p class="LC_warning">'.
                   &mt('Unable to plot the requested statistic.').                    &mt('Unable to plot the requested statistic.').
                   '</h3>');                    '</p>');
         return;          return;
     }      }
     #      #
     # Build up the data sets to plot      # Build up the data sets to plot
     my @Labels;       my @Labels;
     my @Data;      my @Data;
     my $max = 1;      my $max = 1;
     foreach my $data (@StatsArray) {      foreach my $data (@StatsArray) {
Line 645  sub make_single_stat_plot { Line 1048  sub make_single_stat_plot {
     }      }
     #      #
     $r->print("<p>".&Apache::loncommon::DrawBarGraph($title,      $r->print("<p>".&Apache::loncommon::DrawBarGraph($title,
                                                      'Problem Number',                                                       &mt('Problem Number'),
                                                      $yaxis,                                                       $yaxis,
                                                      $max,                                                       $max,
                                                      undef, # colors                                                       undef, # colors
Line 663  sub degrees_plot { Line 1066  sub degrees_plot {
     my $plot = '';      my $plot = '';
     my $ymax = 0;      my $ymax = 0;
     my $ymin = 0;      my $ymin = 0;
     my @Disc; my @Diff; my @Labels;          my @Disc; my @Diff; my @Labels;
     foreach my $data (@StatsArray) {      foreach my $data (@StatsArray) {
         push(@Labels,$data->{'problem_num'});          push(@Labels,$data->{'problem_num'});
         my $disc = $data->{'deg_of_disc'};          my $disc = $data->{'deg_of_disc'};
Line 710  sub degrees_plot { Line 1113  sub degrees_plot {
     my $diffdata .= '<data>'.join(',',@Labels).'</data>'.$/.      my $diffdata .= '<data>'.join(',',@Labels).'</data>'.$/.
                     '<data>'.join(',',@Diff).'</data>'.$/;                      '<data>'.join(',',@Diff).'</data>'.$/;
     #      #
       my $title = &mt('Degree of Discrimination[_1]and Degree of Difficulty','\n');
       if ($xmax > 50) {
           $title = &mt('Degree of Discrimination and Degree of Difficulty');
       }
       my %lt = &Apache::lonlocal::texthash(
           'alttag' => 'Degree of Discrimination and Degree of Difficulty Plot',
           'xlabel' => 'Problem Number',
       );
       #
     $plot=<<"END";      $plot=<<"END";
 <gnuplot   <gnuplot 
     texfont="10"      texfont="10"
Line 720  sub degrees_plot { Line 1132  sub degrees_plot {
     align="center"      align="center"
     border="on"      border="on"
     transparent="on"      transparent="on"
     alttag="Sample Plot"      alttag="$lt{'alttag'}"
     samples="100"      samples="100"
     bgcolor="xffffff"      bgcolor="xffffff"
     height="$height"      height="$height"
Line 729  sub degrees_plot { Line 1141  sub degrees_plot {
         pos="top right"          pos="top right"
         title=""          title=""
         box="off" />          box="off" />
     <title>Degree of Discrmination and Degree of Difficulty</title>      <title>$title</title>
     <axis xmin="0" ymin="$ymin" xmax="$xmax" ymax="$ymax" color="x000000" />      <axis xmin="0" ymin="$ymin" xmax="$xmax" ymax="$ymax" color="x000000" />
     <xlabel>Problem Number</xlabel>      <xlabel>$lt{'xlabel'}</xlabel>
     <curve       <curve 
         linestyle="linespoints"           linestyle="linespoints" 
         name="DoDisc"           name="DoDisc" 
Line 748  sub degrees_plot { Line 1160  sub degrees_plot {
     </curve>      </curve>
 </gnuplot>  </gnuplot>
 END  END
     my $plotresult =       my $plotresult =
         '<p>'.&Apache::lonxml::xmlparse($r,'web',$plot).'</p>'.$/;          '<p>'.&Apache::lonxml::xmlparse($r,'web',$plot).'</p>'.$/;
     $r->print($plotresult);      $r->print($plotresult);
     return;      return;
Line 793  sub tries_data_plot { Line 1205  sub tries_data_plot {
                           '<data>'.join(',',@Mean).'</data>'.$/.                            '<data>'.join(',',@Mean).'</data>'.$/.
                           '<data>'.join(',',@STD).'</data>'.$/;                            '<data>'.join(',',@STD).'</data>'.$/;
     #      #
       my $title = &mt('Mean and S.D. of Tries');
       if ($xmax > 30) {
           $title = &mt('Mean and Standard Deviation of Tries');
       }
       #
       my %lt = &Apache::lonlocal::texthash(
           'alttag' => 'Mean and S.D of Tries Plot',
           'xlabel' => 'Problem Number',
           'ylabel' => 'Number of Tries',
       );
     $plot=<<"END";      $plot=<<"END";
 <gnuplot   <gnuplot 
     texfont="10"      texfont="10"
Line 803  sub tries_data_plot { Line 1225  sub tries_data_plot {
     align="center"      align="center"
     border="on"      border="on"
     transparent="on"      transparent="on"
     alttag="Sample Plot"      alttag="$lt{'alttag'}"
     samples="100"      samples="100"
     bgcolor="xffffff"      bgcolor="xffffff"
     height="$height"      height="$height"
     width="$width">      width="$width">
     <title>Mean and S.D. of Tries</title>      <title>$title</title>
     <axis xmin="0" ymin="0" xmax="$xmax" ymax="$ymax" color="x000000" />      <axis xmin="0" ymin="0" xmax="$xmax" ymax="$ymax" color="x000000" />
     <xlabel>Problem Number</xlabel>      <xlabel>$lt{'xlabel'}</xlabel>
       <ylabel>$lt{'ylabel'}</ylabel>
     <curve       <curve 
         linestyle="yerrorbars"          linestyle="yerrorbars"
         name="S.D. Tries"           name="S.D. Tries" 
Line 827  sub tries_data_plot { Line 1250  sub tries_data_plot {
     </curve>      </curve>
 </gnuplot>  </gnuplot>
 END  END
     my $plotresult =       my $plotresult =
         '<p>'.&Apache::lonxml::xmlparse($r,'web',$plot).'</p>'.$/;          '<p>'.&Apache::lonxml::xmlparse($r,'web',$plot).'</p>'.$/;
     $r->print($plotresult);      $r->print($plotresult);
     return;      return;
Line 835  END Line 1258  END
   
 sub plot_dropdown {  sub plot_dropdown {
     my $current = '';      my $current = '';
       my $title;
     #      #
     if (defined($ENV{'form.plot'})) {      if (defined($env{'form.plot'})) {
         $current = $ENV{'form.plot'};          $current = $env{'form.plot'};
     }      }
     #      #
     my @Additional_Plots = (      my @Additional_Plots = (
                             { graphable=>'yes',                              { graphable=>'yes',
                               name => 'degrees',                                name => 'degrees',
                               title => 'DoDisc and DoDiff' },                                title => 'Difficulty Indexes' },
                             { graphable=>'yes',                              { graphable=>'yes',
                               name => 'tries statistics',                                name => 'tries statistics',
                               title => 'Mean and S.D. of Tries' });                                title => 'Tries Statistics' });
     #      #
     my $Str= "\n".'<select name="plot" size="1">';      my $Str= "\n".'<select name="plot" size="1">';
     $Str .= '<option name="none"></option>'."\n";      $Str .= '<option name="none"></option>'."\n";
     $Str .= '<option name="none2">none</option>'."\n";      $Str .= '<option name="none2">'.&mt('none').'</option>'."\n";
     foreach my $field (@Fields,@Additional_Plots) {      foreach my $field (@Additional_Plots,@Fields) {
         if (! exists($field->{'graphable'}) ||          if (! exists($field->{'graphable'}) ||
             $field->{'graphable'} ne 'yes') {              $field->{'graphable'} ne 'yes') {
             next;              next;
         }          }
         $Str .= '<option value="'.$field->{'name'}.'"';          $Str .= '<option value="'.$field->{'name'}.'"';
         if ($field->{'name'} eq $current) {          if ($field->{'name'} eq $current) {
             $Str .= ' selected ';              $Str .= ' selected="selected"';
         }          }
         $Str.= '>'.&mt($field->{'title'}).'</option>'."\n";          $title = &mt($field->{'long_title'});
           $title = &mt($field->{'title'}) if (!$title);
           $Str.= '>'.$title.'</option>'."\n";
     }      }
     $Str .= '</select>'."\n";      $Str .= '</select>'."\n";
     return $Str;      return $Str;
Line 881  sub Excel_output { Line 1307  sub Excel_output {
     &compute_all_statistics($r);      &compute_all_statistics($r);
     my $c = $r->connection;      my $c = $r->connection;
     return if ($c->aborted());      return if ($c->aborted());
       #
       my ($starttime,$endtime) = &Apache::lonstathelpers::get_time_limits();
     ##      ##
     ## Create the excel workbook      ## Create the excel workbook
     my $filename = '/prtspool/'.      my ($excel_workbook,$filename,$format) =
         $ENV{'user.name'}.'_'.$ENV{'user.domain'}.'_'.          &Apache::loncommon::create_workbook($r);
         time.'_'.rand(1000000000).'.xls';      return if (! defined($excel_workbook));
     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      # Add a worksheet
     my $sheetname = $ENV{'course.'.$ENV{'request.course.id'}.'.description'};      my $sheetname = $env{'course.'.$env{'request.course.id'}.'.description'};
     if (length($sheetname) > 31) {      if (length($sheetname) > 31) {
         $sheetname = substr($sheetname,0,31);          $sheetname = substr($sheetname,0,31);
     }      }
Line 920  sub Excel_output { Line 1329  sub Excel_output {
     #      #
     # Put the course description in the header      # Put the course description in the header
     $excel_sheet->write($rows_output,$cols_output++,      $excel_sheet->write($rows_output,$cols_output++,
                    $ENV{'course.'.$ENV{'request.course.id'}.'.description'});                     $env{'course.'.$env{'request.course.id'}.'.description'},
                           $format->{'h1'});
     $cols_output += 3;      $cols_output += 3;
     #      #
     # Put a description of the sections listed      # Put a description of the sections listed
     my $sectionstring = '';      my $sectionstring = '';
     my @Sections = @Apache::lonstatistics::SelectedSections;      $excel_sheet->write($rows_output,$cols_output++,
     if (scalar(@Sections) > 1) {                          &Apache::lonstatistics::section_and_enrollment_description('plaintext'),
         if (scalar(@Sections) > 2) {                          $format->{'h3'});
             my $last = pop(@Sections);      $cols_output += scalar(&Apache::lonstatistics::get_selected_sections());
             $sectionstring = "Sections ".join(', ',@Sections).', and '.$last;      $cols_output += scalar(&Apache::lonstatistics::get_selected_groups());
         } else {  
             $sectionstring = "Sections ".join(' and ',@Sections);  
         }  
     } else {  
         if ($Sections[0] eq 'all') {  
             $sectionstring = "All sections";  
         } else {  
             $sectionstring = "Section ".$Sections[0];  
         }  
     }  
     $excel_sheet->write($rows_output,$cols_output++,$sectionstring);  
     $cols_output += scalar(@Sections);  
     #      #
     # Time restrictions      # Time restrictions
     my $time_string;      my $time_string;
Line 957  sub Excel_output { Line 1355  sub Excel_output {
         # See note above about lonlocal:locallocaltime          # See note above about lonlocal:locallocaltime
         $time_string .= 'Data collected before '.localtime($endtime).'.';          $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      # Put the date in there too
     $excel_sheet->write($rows_output,$cols_output++,      $excel_sheet->write($rows_output,$cols_output++,
                         'Compiled on '.localtime(time));                          'Compiled on '.localtime(time));
     #      #
     $rows_output++;       $rows_output++;
     $cols_output=0;      $cols_output=0;
     #      ##
     # Long Headers      ## Sequence Statistics
     foreach my $field (@Fields) {      ##
         next if ($field->{'name'} eq 'problem_num');      &write_headers($excel_sheet,$format,\$rows_output,\$cols_output,
         next if ($field->{'selected'} ne 'yes');                     \@SeqFields);
         if (exists($field->{'long_title'})) {      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++,              $excel_sheet->write($rows_output,$cols_output++,
                                 $field->{'long_title'});                                  $data->{$field->{'name'}},$fieldformat);
         } else {  
             $excel_sheet->write($rows_output,$cols_output++,'');  
         }          }
           $rows_output++;
           $cols_output=0;
     }      }
       ##
       ## Resource Statistics
       ##
     $rows_output++;      $rows_output++;
     $cols_output=0;      $cols_output=0;
     # Brief headers      &write_headers($excel_sheet,$format,\$rows_output,\$cols_output,
     foreach my $field (@Fields) {                     \@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) {      foreach my $data (@StatsArray) {
         $cols_output=0;          $cols_output=0;
         foreach my $field (@Fields) {          foreach my $field (@Fields) {
             next if ($field->{'selected'} ne 'yes');              next if ($field->{'selected'} ne 'yes');
             next if ($field->{'name'} eq 'problem_num');              next if ($field->{'name'} eq 'problem_num');
               my $fieldformat = undef;
               if (exists($field->{'excel_format'})) {
                   $fieldformat = $format->{$field->{'excel_format'}};
               }
             $excel_sheet->write($rows_output,$cols_output++,              $excel_sheet->write($rows_output,$cols_output++,
                                 $data->{$field->{'name'}});                                  $data->{$field->{'name'}},$fieldformat);
         }          }
         $rows_output++;          $rows_output++;
           $cols_output=0;
     }      }
     #      #
     $excel_workbook->close();      $excel_workbook->close();
Line 1008  sub Excel_output { Line 1420  sub Excel_output {
     return;      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 {
               $excel_sheet->write($$rows_output,${$cols_output},'');
           }
           ${$cols_output}+= 1;
       }
       ${$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;
   }
   
 ##################################################  ##################################################
 ##################################################  ##################################################
 ##  ##
Line 1018  sub Excel_output { Line 1468  sub Excel_output {
 sub compute_statistics_on_sequence {  sub compute_statistics_on_sequence {
     my ($seq) = @_;      my ($seq) = @_;
     my @Data;      my @Data;
     foreach my $res (@{$seq->{'contents'}}) {      foreach my $res (&Apache::lonstathelpers::get_resources($navmap,$seq)) {
         next if ($res->{'type'} ne 'assessment');          foreach my $part (@{$res->parts}) {
         foreach my $part (@{$res->{'parts'}}) {              next if (($res->is_survey($part)) || ($res->is_anonsurvey($part))) ;
             #              #
             # This is where all the work happens              # This is where all the work happens
             my $data = &get_statistics($seq,$res,$part,scalar(@StatsArray)+1);              my $data = &get_statistics($seq,$res,$part,scalar(@StatsArray)+1);
Line 1038  sub compute_all_statistics { Line 1488  sub compute_all_statistics {
         return;          return;
     }      }
     my $c = $r->connection;      my $c = $r->connection;
     foreach my $seq (&Apache::lonstatistics::Sequences_with_Assess()) {      foreach my $seq (@sequences) {
         last if ($c->aborted);          last if ($c->aborted);
         next if ($seq->{'num_assess'} < 1);          &compute_sequence_statistics($seq);
         &compute_statistics_on_sequence($seq);          &compute_statistics_on_sequence($seq);
     }      }
 }  }
Line 1109  sub sort_data { Line 1559  sub sort_data {
   
 =item &get_statistics()  =item &get_statistics()
   
 Wrapper routine from the call to loncoursedata::get_problem_statistics.    Wrapper routine from the call to loncoursedata::get_problem_statistics.
 Calls lonstathelpers::get_time_limits() to limit the data set by time  Calls lonstathelpers::get_time_limits() to limit the data set by time
 and &compute_discrimination_factor  and &compute_discrimination_factor
   
 Inputs: $sequence, $resource, $part, $problem_num  Inputs: $sequence, $resource, $part, $problem_num
   
 Returns: Hash reference with statistics data from   Returns: Hash reference with statistics data from
 loncoursedata::get_problem_statistics.  loncoursedata::get_problem_statistics.
   
 =cut  =cut
Line 1126  sub get_statistics { Line 1576  sub get_statistics {
     my ($sequence,$resource,$part,$problem_num) = @_;      my ($sequence,$resource,$part,$problem_num) = @_;
     #      #
     my ($starttime,$endtime) = &Apache::lonstathelpers::get_time_limits();      my ($starttime,$endtime) = &Apache::lonstathelpers::get_time_limits();
     my $symb = $resource->{'symb'};      my $symb = $resource->symb;
     my $courseid = $ENV{'request.course.id'};      my $courseid = $env{'request.course.id'};
     #      #
     my $data = &Apache::loncoursedata::get_problem_statistics      my $data = &Apache::loncoursedata::get_problem_statistics
                         (\@Apache::lonstatistics::SelectedSections,                          ([&Apache::lonstatistics::get_selected_sections()],
                            [&Apache::lonstatistics::get_selected_groups()],
                          $Apache::lonstatistics::enrollment_status,                           $Apache::lonstatistics::enrollment_status,
                          $symb,$part,$courseid,$starttime,$endtime);                           $symb,$part,$courseid,$starttime,$endtime);
       $data->{'symb'}        = $symb;
     $data->{'part'}        = $part;      $data->{'part'}        = $part;
     $data->{'problem_num'} = $problem_num;      $data->{'problem_num'} = $problem_num;
     $data->{'container'}   = $sequence->{'title'};      $data->{'container'}   = $sequence->compTitle;
     $data->{'title'}       = $resource->{'title'};      $data->{'title'}       = $resource->compTitle;
     $data->{'title.link'}  = $resource->{'src'}.'?symb='.      $data->{'title.link'}  = $resource->src.'?symb='.
         &Apache::lonnet::escape($resource->{'symb'});          &escape($resource->symb);
     #      #
     if ($SelectedFields{'deg_of_disc'}) {      if ($SelectedFields{'deg_of_disc'}) {
         $data->{'deg_of_disc'} =           $data->{'deg_of_disc'} =
             &compute_discrimination_factor($resource,$part,$sequence);              &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::get_selected_sections();
           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];
           my %storestats =
               &LONCAPA::lonmetadata::dynamic_metadata_storage($data);
           my ($dom,$user) = ($urlres=~m{^($LONCAPA::domain_re)/($LONCAPA::username_re)});
           &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)
   #    my $duedate = &Apache::lonnet::EXT('resource.'.$part.'.duedate',$symb);;
   #    my $opendate = &Apache::lonnet::EXT('resource.'.$part.'.opendate',$symb);
   #    my $maxtries = &Apache::lonnet::EXT('resource.'.$part.'.maxtries',$symb);
   #    my $hinttries = &Apache::lonnet::EXT('resource.'.$part.'.hinttries',$symb);
       my $weight = &Apache::lonnet::EXT('resource.'.$part.'.weight',$symb);
       $data->{'weight'} = $weight;
   #    $data->{'duedate'} = $duedate;
   #    $data->{'opendate'} = $opendate;
   #    $data->{'maxtries'} = $maxtries;
   #    $data->{'hinttries'} = $hinttries;
   #    $data->{'resptypes'} = join(',',@{$resource->{'partdata'}->{$part}->{'ResponseTypes'}});
     return $data;      return $data;
 }  }
   
   
 ###############################################  ###############################################
 ###############################################  ###############################################
   
Line 1164  Returns: integer between -1 and 1 Line 1645  Returns: integer between -1 and 1
 ###############################################  ###############################################
 ###############################################  ###############################################
 sub compute_discrimination_factor {  sub compute_discrimination_factor {
     my ($resource,$part,$sequence) = @_;      my ($resource,$part,$seq) = @_;
       my $symb = $resource->symb;
     my @Resources;      my @Resources;
     foreach my $res (@{$sequence->{'contents'}}) {      foreach my $res (&Apache::lonstathelpers::get_resources($navmap,$seq)){
         next if ($res->{'symb'} eq $resource->{'symb'});          next if ($res->symb eq $symb);
         push (@Resources,$res->{'symb'});          push (@Resources,$res->symb);
     }      }
     #      #
     # rank      # rank
     my $ranking =       my ($starttime,$endtime) = &Apache::lonstathelpers::get_time_limits();
       my $ranking =
         &Apache::loncoursedata::rank_students_by_scores_on_resources          &Apache::loncoursedata::rank_students_by_scores_on_resources
         (\@Resources,          (\@Resources,
          \@Apache::lonstatistics::SelectedSections,           [&Apache::lonstatistics::get_selected_sections()],
          $Apache::lonstatistics::enrollment_status,undef);           [&Apache::lonstatistics::get_selected_groups()],
            $Apache::lonstatistics::enrollment_status,undef,
            $starttime,$endtime, $symb);
     #      #
     # compute their percent scores on the problems in the sequence,      # compute their percent scores on the problems in the sequence,
     my $number_to_grab = int(scalar(@{$ranking})/4);      my $number_to_grab = int(scalar(@{$ranking})/4);
     my $num_students = scalar(@{$ranking});      my $num_students = scalar(@{$ranking});
     my @BottomSet = map { $_->[&Apache::loncoursedata::RNK_student()];       my @BottomSet = map { $_->[&Apache::loncoursedata::RNK_student()];
                       } @{$ranking}[0..$number_to_grab];                        } @{$ranking}[0..$number_to_grab];
     my @TopSet    =       my @TopSet    =
         map {           map {
             $_->[&Apache::loncoursedata::RNK_student()];               $_->[&Apache::loncoursedata::RNK_student()];
           } @{$ranking}[($num_students-$number_to_grab)..($num_students-1)];            } @{$ranking}[-$number_to_grab..0];
     my ($bottom_sum,$bottom_max) =       if (! @BottomSet || (@BottomSet == 1 && $BottomSet[0] eq '') ||
         &Apache::loncoursedata::get_sum_of_scores($resource,$part,\@BottomSet);          ! @TopSet    || (@TopSet    == 1 && $TopSet[0]    eq '')) {
     my ($top_sum,$top_max) =           return 'nan';
         &Apache::loncoursedata::get_sum_of_scores($resource,$part,\@TopSet);      }
       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;      my $deg_of_disc;
     if ($top_max == 0 || $bottom_max==0) {      if ($top_max == 0 || $bottom_max==0) {
         $deg_of_disc = 'nan';          $deg_of_disc = 'nan';
Line 1204  sub compute_discrimination_factor { Line 1695  sub compute_discrimination_factor {
   
 ###############################################  ###############################################
 ###############################################  ###############################################
   ##
   ## 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;
       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::get_selected_sections()],
                        [&Apache::lonstatistics::get_selected_groups()],
                        $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::get_selected_sections()],
            [&Apache::lonstatistics::get_selected_groups()],
            $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 {
           $kr_21 = 'nan';
       }
       $SeqStat{$symb}->{'countmax'} = $cmax;
       $SeqStat{$symb}->{'countmin'} = $cmin;
       $SeqStat{$symb}->{'countstd'} = $cSTD;
       $SeqStat{$symb}->{'countmean'} = $cMean;
       $SeqStat{$symb}->{'count'} = $ccount;
       $SeqStat{$symb}->{'items'} = $K;
       $SeqStat{$symb}->{'KR-21'}=$kr_21;
       return;
   }
   
   
   
 =pod   =pod 
   
Line 1264  Number of Students had at least one disc Line 1822  Number of Students had at least one disc
   
 =cut  =cut
   
   
 ############################################################  
 ############################################################  
 ##  
 ##  How this all works:  
 ##     Statistics are computed by calling &get_statistics with the sequence,  
 ##     resource, and part id to run statistics on.  At various places within  
 ##     the loops which compute the statistics, as well as before and after   
 ##     the entire process, subroutines can be called.  The subroutines are  
 ##     registered to the following hooks:  
 ##  
 ##         hook          subroutine inputs  
 ##     ----------------------------------------------------------  
 ##         pre           $r,$count  
 ##         pre_seq       $r,$count,$seq  
 ##         pre_res       $r,$count,$seq,$res  
 ##         calc          $r,$count,$seq,$res,$data  
 ##         post_res      $r,$count,$seq,$res  
 ##         post_seq      $r,$count,$seq  
 ##         post          $r,$count  
 ##  
 ##         abort         $r  
 ##  
 ##     subroutines will be called in the order in which they are registered.  
 ##     
 ############################################################  
 ############################################################  
 {  
   
 my %hooks;  
 my $aborted = 0;  
   
 sub abort_computation {  
     $aborted = 1;  
 }  
   
 sub clear_hooks {  
     $aborted = 0;  
     undef(%hooks);  
 }  
   
 sub register_hook {  
     my ($hookname,$subref)=@_;  
     if ($hookname !~ /^(pre|pre_seq|pre_res|post|post_seq|post_res|calc)$/){  
         return;  
     }  
     if (ref($subref) ne 'CODE') {  
         &Apache::lonnet::logthis('attempt to register hook to non-code: '.  
                                  $hookname,' = '.$subref);  
     } else {  
         if (exists($hooks{$hookname})) {  
             push(@{$hooks{$hookname}},$subref);  
         } else {  
             $hooks{$hookname} = [$subref];  
         }  
     }  
     return;  
 }  
   
 sub run_hooks {  
     my $context = shift();  
     foreach my $hook (@{$hooks{$context}}) {   
         if ($aborted && $context ne 'abort') {  
             last;  
         }  
         my $retvalue = $hook->(@_);  
         if (defined($retvalue) && $retvalue eq '0') {  
             $aborted = 1 if (! $aborted);  
         }  
     }  
 }  
   
 sub run_statistics {  
     my ($r) = @_;  
     my $count = 0;  
     &run_hooks('pre',$r,$count);  
     foreach my $seq (&Apache::lonstatistics::Sequences_with_Assess()) {  
         last if ($aborted);  
         next if ($seq->{'num_assess'}<1);  
         &run_hooks('pre_seq',$r,$count,$seq);  
         foreach my $res (@{$seq->{'contents'}}) {  
             last if ($aborted);  
             next if ($res->{'type'} ne 'assessment');  
             &run_hooks('pre_res',$r,$count,$seq,$res);              
             foreach my $part (@{$res->{'parts'}}) {  
                 last if ($aborted);  
                 #  
                 # This is where all the work happens  
                 my $data = &get_statistics($seq,$res,$part,++$count);  
                 &run_hooks('calc',$r,$count,$seq,$res,$part,$data);   
             }  
             &run_hooks('post_res',$r,$count,$seq,$res);  
         }  
         &run_hooks('post_seq',$r,$count,$seq);  
     }  
     if ($aborted) {  
         &run_hooks('abort',$r);  
     } else {  
         &run_hooks('post',$r,$count);  
     }  
     return;  
 }  
   
 } # End of %hooks scope  
   
 ############################################################  ############################################################
 ############################################################  ############################################################
   
Removed from v.1.76  
changed lines
  Added in v.1.122.2.2

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