Diff for /loncom/interface/lonstatistics.pm between versions 1.59 and 1.142.2.1

version 1.59, 2003/02/18 20:27:33 version 1.142.2.1, 2008/12/12 17:11:27
Line 1 Line 1
 # The LearningOnline Network with CAPA  # The LearningOnline Network with CAPA
 # (Publication Handler  
 #  #
 # $Id$  # $Id$
 #  #
Line 26 Line 25
 # http://www.lon-capa.org/  # http://www.lon-capa.org/
 #  #
 # (Navigate problems for statistical reports  # (Navigate problems for statistical reports
 # YEAR=2001  
 # 5/5,7/9,7/25/1,8/11,9/13,9/26,10/5,10/9,10/22,10/26 Behrouz Minaei  
 # 11/1,11/4,11/16,12/14,12/16,12/18,12/20,12/31 Behrouz Minaei  
 # YEAR=2002  
 # 1/22,2/1,2/6,2/25,3/2,3/6,3/17,3/21,3/22,3/26,4/7,5/6 Behrouz Minaei  
 # 5/12,5/14,5/15,5/19,5/26,7/16,25/7,29/7  Behrouz Minaei  
 #  #
 ###  ###
   
Line 45  lonstatistics Line 38  lonstatistics
   
 Main handler for statistics and chart.  Main handler for statistics and chart.
   
 =head1 PACKAGES USED  
   
 use strict;  
 use Apache::Constants qw(:common :http);  
 use Apache::lonnet();  
 use Apache::lonhomework;  
 use Apache::loncommon;  
 use Apache::loncoursedata;  
 use Apache::lonhtmlcommon;  
 use Apache::lonproblemanalysis;  
 use Apache::lonproblemstatistics;  
 use Apache::lonstudentassessment;  
 use Apache::lonpercentage;  
 use GDBM_File;  
   
 =over 4  =over 4
   
 =cut  =cut
Line 68  package Apache::lonstatistics; Line 46  package Apache::lonstatistics;
   
 use strict;  use strict;
 use Apache::Constants qw(:common :http);  use Apache::Constants qw(:common :http);
 use Apache::lonnet();  use vars qw(
       @FullClasslist 
       @Students
       @Sections
       @Groups 
       %StudentData
       @StudentDataOrder
       @SelectedStudentData
       $enrollment_status);
   
   use Apache::lonnet;
 use Apache::lonhomework;  use Apache::lonhomework;
 use Apache::loncommon;  use Apache::loncommon;
 use Apache::loncoursedata;  use Apache::loncoursedata;
 use Apache::lonhtmlcommon;  use Apache::lonhtmlcommon;
 use Apache::lonproblemanalysis;  use Apache::lonmysql;
 use Apache::lonproblemstatistics;  use Apache::lonlocal;
 use Apache::lonstudentassessment;  use Apache::longroup;
   use Time::HiRes;
   #
   # Statistics Packages
   use Apache::lonproblemanalysis();
   use Apache::lonsubmissiontimeanalysis();
   use Apache::loncorrectproblemplot();
   use Apache::lonproblemstatistics();
   use Apache::lonstudentassessment();
 use Apache::lonpercentage;  use Apache::lonpercentage;
 use GDBM_File;  use Apache::lonstudentsubmissions();
   use Apache::lonsurveyreports();
   use Apache::longradinganalysis();
   use LONCAPA;
   
   #######################################################
   #######################################################
   
   =pod
   
   =item Package Variables
   
   =item @FullClasslist The full classlist
   
   =item @Students The students we are concerned with for this invocation
   
   =item @Sections The sections available in this class
   
   =item @Groups The groups available in the class
   
   =item $curr_student The student currently being examined
   
   =item $prev_student The student previous in the classlist
   
   =item $next_student The student next in the classlist
   
   =over
   
   =cut 
   
 my @FullClasslist;  #######################################################
 my @Students;  #######################################################
 my @Sections;  #
   # Classlist variables
   #
 my $curr_student;  my $curr_student;
 my $prev_student;  my $prev_student;
 my $next_student;  my $next_student;
Line 97  undef the following package variables: Line 123  undef the following package variables:
   
 =over  =over
   
 =item @FullClasslist The full classlist  =item @FullClasslist
   
 =item @Students The students we are concerned with for this invocation  =item @Students
   
 =item @Sections The sections available in this class  =item @Sections
   
 =item $curr_student The student currently being examined  =item @Groups
   
 =item $prev_student The student previous in the classlist  =item %StudentData
   
 =item $next_student The student next in the classlist  =item @StudentDataOrder
   
   =item @SelectedStudentData
   
   =item $curr_student
   
   =item $prev_student
   
   =item $next_student
   
 =back  =back
   
Line 119  sub clear_classlist_variables { Line 153  sub clear_classlist_variables {
     undef(@FullClasslist);      undef(@FullClasslist);
     undef(@Students);      undef(@Students);
     undef(@Sections);      undef(@Sections);
       undef(@Groups);
       undef(%StudentData);
       undef(@SelectedStudentData);
     undef($curr_student);      undef($curr_student);
     undef($prev_student);      undef($prev_student);
     undef($next_student);      undef($next_student);
Line 136  the following package variables: Line 173  the following package variables:
   
 =over  =over
   
 =item @FullClasslist The full classlist  =item @FullClasslist
   
 =item @Students The students we are concerned with for this invocation  =item @Students
   
 =item @Sections The sections available in this class  =item @Sections
   
 =item $curr_student The student currently being examined  =item @Groups 
   
 =item $prev_student The student previous in the classlist  =item %StudentData
   
 =item $next_student The student next in the classlist  =item @SelectedStudentData
   
   =item $curr_student
   
   =item $prev_student
   
   =item $next_student
   
 =back  =back
   
Line 158  upon the calling context. Line 201  upon the calling context.
 #######################################################  #######################################################
 #######################################################  #######################################################
 sub PrepareClasslist {  sub PrepareClasslist {
     my $r = shift;  
     my %Sections;      my %Sections;
     &clear_classlist_variables();      &clear_classlist_variables();
     #      #
     # Retrieve the classlist      # Retrieve the classlist
     my $cid  = $ENV{'request.course.id'};      my $cid  = $env{'request.course.id'};
     my $cdom = $ENV{'course.'.$cid.'.domain'};      my $cdom = $env{'course.'.$cid.'.domain'};
     my $cnum = $ENV{'course.'.$cid.'.num'};      my $cnum = $env{'course.'.$cid.'.num'};
     my ($classlist,$field_names) = &Apache::loncoursedata::get_classlist($cid,      my ($classlist,$field_names) = &Apache::loncoursedata::get_classlist($cdom,
                                                                   $cdom,$cnum);   $cnum);
     my %valid_section;      my @selected_sections = &get_selected_sections();
     if (exists($ENV{'form.Section'}) && $ENV{'form.Section'} !~ /(all|any)/) {      my @selected_groups = &get_selected_groups();
         if (ref($ENV{'form.Section'})) {      #
             foreach (@$ENV{'form.section'}) {      # Deal with instructors with restricted section access
                 $valid_section{$_}++;      if ($env{'request.course.sec'} !~ /^\s*$/) {
             }          @selected_sections = ($env{'request.course.sec'});
         } else {  
             $valid_section{$_}++;  
         }  
     }      }
     #      #
       # Set up %StudentData
       @StudentDataOrder = qw/fullname username domain id section status groups comments/;
       foreach my $field (@StudentDataOrder) {
           $StudentData{$field}->{'title'} = &mt($field);
           $StudentData{$field}->{'base_width'} = length(&mt($field));
           $StudentData{$field}->{'width'} = 
                                  $StudentData{$field}->{'base_width'};
       }
       #
       # get the status requested
       $enrollment_status = 'Active';
       $enrollment_status = $env{'form.Status'} if (exists($env{'form.Status'}));
       #
       # Get groupmembership
       my ($classgroups,$studentgroups);
       my %curr_groups = &Apache::longroup::coursegroups($cdom,$cnum);
       if (%curr_groups) {
           ($classgroups,$studentgroups) = 
       &Apache::loncoursedata::get_group_memberships($classlist,
                                                             $field_names,
     $cdom,$cnum);
       }
       my $now = time;
   
     # Process the classlist      # Process the classlist
     while (my ($student,$student_data) = each (%$classlist)) {      while (my ($student,$student_data) = each (%$classlist)) {
         my $studenthash = ();          my $studenthash = ();
         for (my $i=0; $i< scalar(@$field_names);$i++) {          for (my $i=0; $i< scalar(@$field_names);$i++) {
             $studenthash->{$field_names->[$i]}=$student_data->[$i];              my $field = $field_names->[$i];
               # Store the data
               $studenthash->{$field}=$student_data->[$i];
               # Keep track of the width of the fields
               next if (! exists($StudentData{$field}));
               my $length = length($student_data->[$i]);
               if ($StudentData{$field}->{'width'} < $length) {
                   $StudentData{$field}->{'width'} = $length; 
               }
           }
           my @studentsgroups = &Apache::loncoursedata::get_students_groups
                                                      ($student,$enrollment_status,
                                                       $classgroups);
           if (@studentsgroups) {
               $studenthash->{'groups'} = join(', ',@studentsgroups);
               $studenthash->{'groupref'} = \@studentsgroups;
           } else {
               $studenthash->{'groups'} = 'none';
               $studenthash->{'groupref'} = []; 
         }          }
         push (@FullClasslist,$studenthash);          push (@FullClasslist,$studenthash);
         #          #
         # Build up a list of sections          # Build up a list of sections
         my $section = $studenthash->{'section'};          my $section = $studenthash->{'section'};
         $section = 'no section' if (! defined($section) || $section =~/^\s*/ );          if (! defined($section) || $section =~/^\s*$/ || $section == -1) {
               $studenthash->{'section'} = 'none';
               $section = $studenthash->{'section'};
           }
         $Sections{$section}++;          $Sections{$section}++;
         #          #
         # Only put in the list those students we are interested in          # Only put in the list those students we are interested in
         if (defined($ENV{'form.Section'}) &&          foreach my $sect (@selected_sections) {
             $ENV{'form.Section'} !~ /(all|any)/ &&               if ( (($sect eq 'all') || 
             ! exists($valid_section{$section})) {                    ($section eq $sect)) &&
             next;                   (($studenthash->{'status'} eq $enrollment_status) || 
                     ($enrollment_status eq 'Any')) 
                    ){
                   my $groupcheck = 0;
                   if (grep(/^all$/,@selected_groups)) {
                       push(@Students,$studenthash);
                       last;
                   } elsif (grep(/^none$/,@selected_groups)) {
                       if ($studenthash->{'groups'} eq 'none') {
                           push(@Students,$studenthash);
                           last;
                       }     
                   } else {
                       foreach my $group (@selected_groups) {
                           if (grep(/^$group$/,@studentsgroups)) {
                               push(@Students,$studenthash);
                               $groupcheck = 1;
                               last;
                           }
                       }
                       if ($groupcheck) {
                           last;
                       }
                   }
               }
         }          }
         push (@Students,$studenthash);  
     }      }
     #      #
     # Put the consolidated section data in the right place      # Put the consolidated section data in the right place
     @Sections = sort {$a<=>$b} keys(%Sections);      if ($env{'request.course.sec'} !~ /^\s*$/) {
           @Sections = ($env{'request.course.sec'});
       } else {
           @Sections = sort {
       if ($a == $a && $b == $b ) { return $a <=> $b; }
       return $a cmp $b;
    } keys(%Sections);
   
           unshift(@Sections,'all'); # Put 'all' at the front of the list
       }
       # Sort the groups
       @Groups = sort {$a cmp $b} keys(%{$studentgroups});
       unshift(@Groups,'all'); # Put 'all' at the front of the list
   
     #      #
     # Sort the Students      # Sort the Students
     my $sortby = 'fullname';      my $sortby = 'fullname';
     @Students = sort {$a->{$sortby} <=> $b->{$sortby}} @Students;      $sortby = $env{'form.sort'} if (exists($env{'form.sort'}));
       my @TmpStudents = sort { lc($a->{$sortby}) cmp lc($b->{$sortby}) ||
                                lc($a->{'fullname'}) cmp lc($b->{'fullname'}) ||
        lc($a->{'username'}) cmp lc($b->{'username'}) } @Students;
       @Students = @TmpStudents;
     #       # 
     # Now deal with that current student thing....      # Now deal with that current student thing....
     if (exists($ENV{'form.StudentAssessmentStudent'})) {      $curr_student = undef;
       if (exists($env{'form.SelectedStudent'})) {
         my ($current_uname,$current_dom) =           my ($current_uname,$current_dom) = 
             split(':',$ENV{'form.StudentAssessmentStudent'});              split(':',$env{'form.SelectedStudent'});
         my $i;          my $i;
         for ($i = 0; $i<=$#Students; $i++) {          for ($i = 0; $i<=$#Students; $i++) {
             next if (($Students[$i]->{'username'} ne $current_uname) ||               next if (($Students[$i]->{'username'} ne $current_uname) || 
                      ($Students[$i]->{'domain'}   ne $current_dom));                       ($Students[$i]->{'domain'}   ne $current_dom));
               $curr_student = $Students[$i];
             last; # If we get here, we have our student.              last; # If we get here, we have our student.
         }          }
         if ($i == 0) {          if (defined($curr_student)) {
             $prev_student = 'none';              if ($i == 0) {
         } else {                  $prev_student = undef;
             $prev_student = $Students[$i-1];              } else {
                   $prev_student = $Students[$i-1];
               }
               if ($i == $#Students) {
                   $next_student = undef;
               } else {
                   $next_student = $Students[$i+1];
               }
         }          }
         if ($i == $#Students) {      }
             $next_student = 'none';      #
         } else {      if (exists($env{'form.StudentData'})) {
             $next_student = $Students[$i+1];   @SelectedStudentData = 
       &Apache::loncommon::get_env_multiple('form.StudentData');
       } else {
           @SelectedStudentData = ('username');
       }
       foreach (@SelectedStudentData) {
           if ($_ eq 'all') {
               @SelectedStudentData = ('all');
               last;
         }          }
     }      }
       #
       return;
 }  }
   
 #######################################################  #######################################################
 #######################################################  #######################################################
   
 sub CheckFormElement {  =pod
     my ($cache, $ENVName, $cacheName, $default)=@_;  
   =item get_selected_sections
   
   Returns an array of the selected sections
   
     if(defined($ENV{'form.'.$ENVName})) {  =cut
         $cache->{$cacheName} = $ENV{'form.'.$ENVName};  
     } elsif(!defined($cache->{$cacheName})) {  #######################################################
         $cache->{$cacheName} = $default;  #######################################################
   sub get_selected_sections {
       my @selected_sections = 
    &Apache::loncommon::get_env_multiple('form.Section');
       @selected_sections = ('all') if (! @selected_sections);
       foreach (@selected_sections) {
           if ($_ eq 'all') {
               @selected_sections = ('all');
           }
     }      }
       #
       # Deal with instructors with restricted section access
       if ($env{'request.course.sec'} !~ /^\s*$/) {
           @selected_sections = ($env{'request.course.sec'});
       }
       return @selected_sections;
   }
   
     return;  #######################################################
   #######################################################
                                                                                       
   =pod
                                                                                       
   =item get_selected_groups
                                                                                       
   Returns an array of the selected groups
                                                                                       
   =cut
                                                                                       
   #######################################################
   #######################################################
   sub get_selected_groups {
       my @selected_groups =
           &Apache::loncommon::get_env_multiple('form.Group');
       @selected_groups = ('all') if (! @selected_groups);
       foreach my $grp (@selected_groups) {
           if ($grp eq 'all') {
               @selected_groups = ('all');
               last;
           }
       }
       return @selected_groups;
 }  }
                                                                                       
   =pod
   
 sub ProcessFormData{  =item &section_and_enrollment_description
     my ($cache)=@_;  
   
     $cache->{'reportKey'} = 'false';  Returns a string describing the currently selected section(s), group(s) and 
   access status.  
   
     &Apache::loncommon::get_unprocessed_cgi($ENV{'QUERY_STRING'},  Inputs: mode = 'plaintext' or 'localized'  (defaults to 'localized')
                                             ['sort','download',      'plaintext' is used for example in Excel spreadsheets.
                                              'reportSelected',  Returns: scalar description string.
                                              'StudentAssessmentStudent',  
                                              'ProblemStatisticsSort']);  =cut
     &CheckFormElement($cache, 'DownloadAll', 'DownloadAll', 'false');  
     if ($cache->{'DownloadAll'} ne 'false') {  #######################################################
         # Clean the hell out of that cache!  #######################################################
         # We cannot untie the hash at this scope (stupid libgd :( )  sub section_and_enrollment_description {
         # So, remove every single key.  What a waste of time....      my ($mode) = @_;
         # Of course, if you are doing this you are probably resigned      if (! defined($mode)) { $mode = 'localized'; }
         # to waiting a while.      my @sections = &Apache::lonstatistics::get_selected_sections();
         &Apache::lonnet::logthis("Cleaning out the cache file");      my @groups = &Apache::lonstatistics::get_selected_groups();
         while (my ($key,undef)=each(%$cache)) {      my $description;
             next if ($key eq 'DownloadAll');      if ($mode eq 'localized') {
             delete($cache->{$key});          $description = &mt('Unable to determine section, groups and access status');
         }      } elsif ($mode eq 'plaintext') {
     }          $description = 'Unable to determine section, groups and access status';
     &CheckFormElement($cache, 'Status', 'Status', 'Active');  
     &CheckFormElement($cache, 'postdata', 'reportSelected', 'Class list');  
     &CheckFormElement($cache, 'reportSelected', 'reportSelected',   
                       'Class list');  
     $cache->{'reportSelected'} =   
         &Apache::lonnet::unescape($cache->{'reportSelected'});  
     &CheckFormElement($cache, 'sort', 'sort', 'fullname');  
     &CheckFormElement($cache, 'download', 'download', 'false');  
     &CheckFormElement($cache, 'StatisticsMaps',   
                       'StatisticsMaps', 'All Maps');  
     &CheckFormElement($cache, 'StatisticsProblemSelect',  
       'StatisticsProblemSelect', 'All Problems');  
     &CheckFormElement($cache, 'StatisticsPartSelect',  
       'StatisticsPartSelect', 'All Parts');  
     if(defined($ENV{'form.Section'})) {  
         my @sectionsSelected = (ref($ENV{'form.Section'}) ?  
                                @{$ENV{'form.Section'}} :  
                                 ($ENV{'form.Section'}));  
         $cache->{'sectionsSelected'} = join(':', @sectionsSelected);  
     } elsif(!defined($cache->{'sectionsSelected'})) {  
         $cache->{'sectionsSelected'} = $cache->{'sectionList'};  
     }  
   
     # student assessment  
     if(defined($ENV{'form.CreateStudentAssessment'}) ||  
        defined($ENV{'form.NextStudent'}) ||  
        defined($ENV{'form.PreviousStudent'})) {  
         $cache->{'reportSelected'} = 'Student Assessment';  
     }  
     if(defined($ENV{'form.NextStudent'})) {  
         $cache->{'StudentAssessmentMove'} = 'next';  
     } elsif(defined($ENV{'form.PreviousStudent'})) {  
         $cache->{'StudentAssessmentMove'} = 'previous';  
     } else {      } else {
         $cache->{'StudentAssessmentMove'} = 'selected';          $description = 'Bad parameter passed to lonstatistics::section_and_enrollment_description';
           &Apache::lonnet::logthis($description);
     }      }
     &CheckFormElement($cache, 'StudentAssessmentStudent',       $description = &section_or_group_text($mode,'section',@sections).
                       'StudentAssessmentStudent', 'All Students');   ' '.&section_or_group_text($mode,'group',@groups);
     $cache->{'StudentAssessmentStudent'} =       if ($mode eq 'localized') {
         &Apache::lonnet::unescape($cache->{'StudentAssessmentStudent'});          $description .= ' '.&mt($env{'form.Status'}.' access status.');
     &CheckFormElement($cache, 'DefaultColumns', 'DefaultColumns', 'false');      } elsif ($mode eq 'plaintext') {
           $description .= ' '.$env{'form.Status'}.' access status.';
     # Problem analysis  
     &CheckFormElement($cache, 'Interval', 'Interval', '1');  
   
     # ProblemStatistcs  
     &CheckFormElement($cache, 'DisplayCSVFormat',  
                       'DisplayFormat', 'Display Table Format');  
     &CheckFormElement($cache, 'ProblemStatisticsAscend',  
                       'ProblemStatisticsAscend', 'Ascending');  
     &CheckFormElement($cache, 'ProblemStatisticsSort',  
                       'ProblemStatisticsSort', 'Homework Sets Order');  
     &CheckFormElement($cache, 'DisplayLegend', 'DisplayLegend',   
       'Hide Legend');  
     &CheckFormElement($cache, 'SortProblems', 'SortProblems',   
                       'Sort Within Sequence');  
   
     # Search only form elements  
     my @headingColumns=();  
     my @sequenceColumns=();  
     my $foundColumn = 0;  
     if(defined($ENV{'form.ReselectColumns'})) {  
         my @reselected = (ref($ENV{'form.ReselectColumns'}) ?   
                           @{$ENV{'form.ReselectColumns'}}  
                           : ($ENV{'form.ReselectColumns'}));  
         foreach (@reselected) {  
             if(/HeadingColumn/) {  
                 push(@headingColumns, $_);  
                 $foundColumn = 1;  
             } elsif(/SequenceColumn/) {  
                 push(@sequenceColumns, $_);  
                 $foundColumn = 1;  
             }  
         }  
     }  
   
     $cache->{'reportKey'} = 'false';  
     if($cache->{'reportSelected'} eq 'Analyze') {  
         $cache->{'reportKey'} = 'Analyze';  
     } elsif($cache->{'reportSelected'} eq 'DoDiffGraph') {  
         $cache->{'reportKey'} = 'DoDiffGraph';  
     } elsif($cache->{'reportSelected'} eq 'PercentWrongGraph') {  
         $cache->{'reportKey'} = 'PercentWrongGraph';  
     }  
   
     if(defined($ENV{'form.DoDiffGraph'})) {  
         $cache->{'reportSelected'} = 'DoDiffGraph';  
         $cache->{'reportKey'} = 'DoDiffGraph';  
     } elsif(defined($ENV{'form.PercentWrongGraph'})) {  
         $cache->{'reportSelected'} = 'PercentWrongGraph';  
         $cache->{'reportKey'} = 'PercentWrongGraph';  
     }  
   
     foreach (keys(%ENV)) {  
         if(/form\.Analyze/) {  
             $cache->{'reportSelected'} = 'Analyze';  
             $cache->{'reportKey'} = 'Analyze';  
             my $data;  
             (undef, $data)=split(':::', $_);  
             $cache->{'AnalyzeInfo'}=$data;  
         } elsif(/form\.HeadingColumn/) {  
             my $value = $_;  
             $value =~ s/form\.//;  
             push(@headingColumns, $value);  
             $foundColumn=1;  
         } elsif(/form\.SequenceColumn/) {  
             my $value = $_;  
             $value =~ s/form\.//;  
             push(@sequenceColumns, $value);  
             $foundColumn=1;  
         }  
     }  
   
     if($foundColumn) {  
         $cache->{'HeadingsFound'} = join(':', @headingColumns);  
         $cache->{'SequencesFound'} = join(':', @sequenceColumns);;  
     }  
     if(!defined($cache->{'HeadingsFound'}) ||   
        $cache->{'DefaultColumns'} ne 'false') {  
         $cache->{'HeadingsFound'}='HeadingColumnFull Name';  
     }  
     if(!defined($cache->{'SequencesFound'}) ||  
        $cache->{'DefaultColumns'} ne 'false') {  
         $cache->{'SequencesFound'}='All Sequences';  
     }      }
     $cache->{'DefaultColumns'} = 'false';      return $description;
   }
   
     return;  #######################################################
   #######################################################
   
   sub section_or_group_text {
       my ($mode,$type,@items) = @_;
       my $text;
       my %phrases = ();
       %{$phrases{'section'}} = (
                                 single => 'Section',
                                 all => 'All sections',
                                 plural => 'Sections',
                                );
       %{$phrases{'group'}} = (
                                 single => 'Group',
                                 all => 'All groups',
                                 plural => 'Groups',
                                );
       if (scalar(@items) == 1 && $items[0] ne 'all') {
           if ($mode eq 'localized') {
               $text = &mt($phrases{$type}{single}.' [_1].',$items[0]);
           } elsif ($mode eq 'plaintext') {
               $text = $phrases{$type}{single}.' '.$items[0].'.';
   
           }
       } elsif (scalar(@items) && $items[0] eq 'all') {
           if ($mode eq 'localized') {
               $text = &mt($phrases{$type}{all}.'.');
           } elsif ($mode eq 'plaintext') {
               $text = $phrases{$type}{all}.'.';
           }
       } elsif (scalar(@items)) {
           my $lastitem = pop(@items);
           if ($mode eq 'localized') {
               $text = &mt($phrases{$type}{plural}.' [_1] and [_2].',
                           join(', ',@items),$lastitem);
           } elsif ($mode eq 'plaintext') {
               $text = $phrases{$type}{plural}.' '.join(', ',@items).' and '.
                       $lastitem.'.';
           }
       }
       return $text;
 }  }
   
   
 =pod  =pod
   
 =item &SortStudents()  =item get_students
   
 Determines which students to display and in which order.  Which are   Returns a list of the selected students
 displayed are determined by their status(active/expired).  The order  
 is determined by the sort button pressed (default to username).  The  
 type of sorting is username, lastname, or section.  
   
 =over 4  =cut
   
 Input: $students, $CacheData  
   
 $students: A array pointer to a list of students (username:domain)  #######################################################
   #######################################################
   sub get_students {
       if (! @Students) {
           &PrepareClasslist()
       }
       return @Students;
   }
   
 $CacheData: A pointer to the hash tied to the cached data  #######################################################
   #######################################################
   
 Output: \@order  =pod
   
 @order: An ordered list of students (username:domain)  =item &current_student()
   
 =back  Returns a pointer to a hash containing data about the currently
   selected student.
   
 =cut  =cut
   
 sub SortStudents {  #######################################################
     my ($cache)=@_;  #######################################################
   sub current_student { 
       return $curr_student;
   }
   
     my @students = split(':::',$cache->{'NamesOfStudents'});  #######################################################
     my @sorted1Students=();  #######################################################
     foreach (@students) {  
         if($cache->{'Status'} eq 'Any' ||   
            $cache->{$_.':Status'} eq $cache->{'Status'}) {  
             push(@sorted1Students, $_);  
         }  
     }  
   
     my $sortBy = '';  =pod
     if(defined($cache->{'sort'})) {  
         $sortBy = ':'.$cache->{'sort'};  =item &previous_student()
     } else {  
         $sortBy = ':fullname';  
     }  
     my @order = sort { lc($cache->{$a.$sortBy}) cmp lc($cache->{$b.$sortBy}) ||  
                        lc($cache->{$a.':fullname'}) cmp lc($cache->{$b.':fullname'}) }   
                 @sorted1Students;  
   
     return \@order;  Returns a pointer to a hash containing data about the student prior
   in the list of students.  Or something.  
   
   =cut
   
   #######################################################
   #######################################################
   sub previous_student { 
       return $prev_student;
 }  }
   
   #######################################################
   #######################################################
   
 =pod  =pod
   
 =item &SpaceColumns()  =item &next_student()
   
 Determines the width of all the columns in the chart.  It is based on  Returns a pointer to a hash containing data about the next student
 the max of the data for that column and its header.  to be viewed.
   
 =over 4  =cut
   
 Input: $students, $studentInformation, $headings, $ChartDB  #######################################################
   #######################################################
   sub next_student { 
       return $next_student;
   }
   
   ##############################################
   ##############################################
   
 $students: An array pointer to a list of students (username:domain)  =pod 
   
 $studentInformatin: The type of data for the student information.  It is  =item &StudentDataSelect($elementname,$status,$numvisible,$selected)
 used as part of the key in $CacheData.  
   Returns html for a selection box allowing the user to choose one (or more) 
   of the fields of student data available (fullname, username, id, section, etc)
   
   =over 4
   
 $headings: The name of the student information columns.  =item $elementname The name of the HTML form element
   
 $ChartDB: The name of the cache database which is opened for read/write.  =item $status 'multiple' or 'single' selection box
   
 Output: None - All data stored in cache.  =item $numvisible The number of options to be visible
   
 =back  =back
   
 =cut  =cut
   
 sub SpaceColumns {  ##############################################
     my ($students,$studentInformation,$headings,$cache)=@_;  ##############################################
   sub StudentDataSelect {
     # Initialize Lengths      my ($elementname,$status,$numvisible)=@_;
     for(my $index=0; $index<(scalar @$headings); $index++) {      if ($numvisible < 1) {
         my @titleLength=split(//,$headings->[$index]);          return;
         $cache->{$studentInformation->[$index].':columnWidth'}=      }
             scalar @titleLength;      #
     }      # Build the form element
       my $Str = "\n";
     foreach my $name (@$students) {      $Str .= '<select name="'.$elementname.'" ';
         foreach (@$studentInformation) {      if ($status ne 'single') {
             my @dataLength=split(//,$cache->{$name.':'.$_});          $Str .= 'multiple="true" ';
             my $length=(scalar @dataLength);      }
             if($length > $cache->{$_.':columnWidth'}) {      $Str .= 'size="'.$numvisible.'" >'."\n";
                 $cache->{$_.':columnWidth'}=$length;      #
       # Deal with 'all'
       $Str .= '    <option value="all" ';
       foreach (@SelectedStudentData) {
           if ($_ eq 'all') {
               $Str .= 'selected ';
               last;
           }
       }
       $Str .= ">all</option>\n";
       #
       # Loop through the student data fields
       foreach my $item (@StudentDataOrder) {
           $Str .= '    <option value="'.$item.'" ';
           foreach (@SelectedStudentData) {
               if ($item eq $_ ) {
                   $Str .= 'selected ';
                   last;
             }              }
         }          }
           $Str .= '>'.$item."</option>\n";
     }      }
       $Str .= "</select>\n";
     return;      return $Str;
 }  }
   
 sub PrepareData {  #######################################################
     my ($c, $cacheDB, $studentInformation, $headings,$r)=@_;  #######################################################
   
     # Test for access to the cache data  =pod
     my $courseID=$ENV{'request.course.id'};  
     my $isRecalculate=0;  
     if(defined($ENV{'form.Recalculate'})) {  
         $isRecalculate=1;  
     }  
   
     my $isCached = &Apache::loncoursedata::TestCacheData($cacheDB,  =item &get_selected_maps($elementname)
                                                          $isRecalculate);  
     if($isCached < 0) {  
         return "Unable to tie hash to db file.";  
     }  
   
     # Download class list information if not using cached data  Input: Name of the <select> form element used to specify the maps.
     my %cache;  
     unless(tie(%cache,'GDBM_File',$cacheDB,&GDBM_WRCREAT(),0640)) {  Returns: Array of symbs of selected maps or the description 'all'.
         return "Unable to tie hash to db file.";     If form.$elementname does not exist, 'all' is returned.
     }  
   
 #    if(!$isCached) {  =cut
         my $processTopResourceMapReturn=  
             &Apache::loncoursedata::ProcessTopResourceMap(\%cache, $c);  #######################################################
         if($processTopResourceMapReturn ne 'OK') {  #######################################################
             untie(%cache);  sub get_selected_maps {
             return $processTopResourceMapReturn;      my ($elementname) = @_;
       my @selected_maps = 
    &Apache::loncommon::get_env_multiple('form.'.$elementname);
       @selected_maps = ('all') if (! @selected_maps);
       foreach my $map (@selected_maps) {
           if ($map eq 'all') {
               @selected_maps = ('all');
               last;
         }          }
  #   }      }
       return @selected_maps;
   }
   
   
   #######################################################
   #######################################################
   
   =pod
   
   =item &selected_sequences_with_assessments
   
   Retrieve the sequences which were selected by the user to show.  
   
     if($c->aborted()) {  Input: $mode: scalar.  Either 'selected' or 'all'.  If not specified,
         untie(%cache);      'selected' is used.
         return 'aborted';   
   Returns: an array containing a navmap object and navmap resources, 
       or an array containing a scalar with an error message.
   
   =cut
   
   #######################################################
   #######################################################
   sub selected_sequences_with_assessments {
       my ($mode) = @_;
       $mode = 'selected' if (! defined($mode));
       my $navmap = Apache::lonnavmaps::navmap->new();
       if (!defined($navmap)) {
           return ('Can not open Coursemap');
       }
       #
       my @sequences = $navmap->retrieveResources(undef,
                                                  sub { shift->is_map(); },1,0,1);
       my $toplevelseq = $navmap->getById('0.0');
       if (!grep(/^\Q$toplevelseq\E$/,@sequences)) {
           unshift(@sequences,$toplevelseq);
     }      }
   
     my $classlist=&Apache::loncoursedata::DownloadClasslist($courseID,      my @sequences_with_assessments;
                                                 $cache{'ClasslistTimestamp'},      foreach my $sequence (@sequences) {
                                                 $c);   if ($navmap->hasResource($sequence,sub { shift->is_problem(); },0,1)){
     foreach (keys(%$classlist)) {              push(@sequences_with_assessments,$sequence);
         if(/^(con_lost|error|no_such_host)/i) {  
             untie(%cache);  
             return "Error getting student data.";  
         }          }
     }      }
       #
       my @sequences_to_show;
       foreach my $sequence (@sequences_with_assessments) {
           if ($mode eq 'all') {
               push (@sequences_to_show,$sequence);
           } elsif ($mode eq 'selected') {
               foreach my $map_symb (&get_selected_maps('Maps')) {
                   if ($sequence->symb eq $map_symb || $map_symb eq 'all'){
                       push (@sequences_to_show,$sequence);
                       last; # Only put it in once
                   }
               }
           }
   
     if($c->aborted()) {  
         untie(%cache);  
         return 'aborted';   
     }      }
       return $navmap,@sequences_to_show;
   }
   
     # Active is a temporary solution, remember to change  ##############################################
     Apache::loncoursedata::ProcessClasslist(\%cache,$classlist,$courseID,$c);  ##############################################
     if($c->aborted()) {  
         untie(%cache);  
         return 'aborted';   
     }  
   
     &ProcessFormData(\%cache);  =pod 
     my $students = &SortStudents(\%cache);  
     &SpaceColumns($students, $studentInformation, $headings, \%cache);  
     $cache{'updateTime:columnWidth'}=24;  
   
     my $download = $cache{'download'};  =item &map_select($elementname,$status,$numvisible,$restriction) 
     my $downloadAll = $cache{'DownloadAll'};  
     my @allStudents=();  
     if($download ne 'false') {  
         $cache{'download'} = 'false';  
     } elsif($downloadAll ne 'false') {  
         $cache{'DownloadAll'} = 'false';  
         if($downloadAll eq 'sorted') {  
             @allStudents = @$students;  
         } else {  
             @allStudents = split(':::', $cache{'NamesOfStudents'});  
         }  
     }  
   
     untie(%cache);  Returns html for a selection box allowing the user to choose one (or more) 
   of the sequences in the course.  The values of the sequences are the symbs.
   If the top sequence is selected, the value 'top' will result.
   
     if($download ne 'false') {  =over 4
         my @who = ($download);  
         if(&Apache::loncoursedata::DownloadStudentCourseData(\@who, 'false',  =item $elementname The name of the HTML form element
                                                              $cacheDB, 'true',  
                                                              'false', $courseID,  =item $status 'multiple' or 'single' selection box
                                                              $r, $c) ne 'OK') {  
             return 'Stop at download individual';  
         }  
     } elsif($downloadAll ne 'false') {  
         if(&Apache::loncoursedata::DownloadStudentCourseData(\@allStudents,  
                                                              'false',  
                                                              $cacheDB, 'true',  
                                                              'true', $courseID,  
                                                              $r, $c) ne 'OK') {  
             return 'Stop at download all';  
         }  
     }  
   
     return ('OK', $students);  
 }  
   
 sub BuildClasslist {  
     my ($cacheDB,$students,$studentInformation,$headings,$r)=@_;  
   
     my %cache;  
     unless(tie(%cache,'GDBM_File',$cacheDB,&GDBM_READER(),0640)) {  
         return '<html><body>Unable to tie database.</body></html>';  
     }  
   
 #    my $Ptr = '';  
 #    $Ptr .= '<table border="0"><tbody>';  
 #    $Ptr .= '<tr><td align="right"><b>Select Sections</b>';  
 #    $Ptr .= '</td>'."\n";  
 #    $Ptr .= '<td align="left">'."\n";  
 #    my @sectionsSelected = split(':',$cache{'sectionsSelected'});  
 #    my @sections = split(':',$cache{'sectionList'});  
 #    $Ptr .= &Apache::lonhtmlcommon::MultipleSectionSelect(\@sections,  
 #                                                          \@sectionsSelected,  
 #                                                          'Statistics');  
 #    $Ptr .= '</td></tr></table><br>';  
 #    $r->print($Ptr);  
 #    $r->rflush();  
 #    my %mySections = ();  
 #    foreach (@sections) { $mySections{$_} = 'True'; }  
 #    $r->print("<br>$cache{'sectionsSelected'}<br>");  
   
     my $Str='';  
     $Str .= '<table border="0"><tr><td bgcolor="#777777">'."\n";  
     $Str .= '<table border="0" cellpadding="3"><tr bgcolor="#e6ffff">'."\n";  
   
     my $displayString = '<td align="left"><a href="/adm/statistics?';  
     $displayString .= 'sort=LINKDATA">DISPLAYDATA&nbsp</a></td>'."\n";  
     $Str .= &Apache::lonhtmlcommon::CreateHeadings(\%cache,  
                                                    $studentInformation,  
                                                    $headings, $displayString);  
     $Str .= '</tr>'."\n";  
   
     my $alternate=0;  
     foreach (@$students) {  
 #        if ($mySections{$cache{$_.':'.'section'}} ne 'True') {next;}  
         my ($username, $domain) = split(':', $_);  
         if($alternate) {  
             $Str .= '<tr bgcolor="#ffffe6">';  
         } else {  
             $Str .= '<tr bgcolor="#ffffc6">';  
         }  
         $alternate = ($alternate + 1) % 2;  
         foreach my $data (@$studentInformation) {  
             $Str .= '<td>';  
             if($data eq 'fullname') {  
                 $Str .= '<a href="/adm/statistics?reportSelected=';  
                 $Str .= &Apache::lonnet::escape('Student Assessment');  
                 $Str .= '&StudentAssessmentStudent=';  
                 $Str .= &Apache::lonnet::escape($cache{$_.':'.$data}).'">';  
                 $Str .= $cache{$_.':'.$data}.'&nbsp';  
                 $Str .= '</a>';  
             } elsif($data eq 'updateTime') {  
                 $Str .= '<a href="/adm/statistics?reportSelected=';  
                 $Str .= &Apache::lonnet::escape('Class list');  
                 $Str .= '&download='.$_.'">';  
                 $Str .= $cache{$_.':'.$data}.'&nbsp';  
                 $Str .= '&nbsp</a>';  
             } else {  
                 $Str .= $cache{$_.':'.$data}.'&nbsp';  
             }  
   
             $Str .= '</td>'."\n";  =item $numvisible The number of options to be visible
   
   =back
   
   =cut
   
   ##############################################
   ##############################################
   sub map_select {
       my ($elementname,$status,$numvisible)=@_;
       if ($numvisible < 1) {
           return;
       }
       #
       # Set up array of selected items
       my @selected_maps = &get_selected_maps($elementname);
       #
       # Build the form element
       my $form = "\n";
       $form .= '<select name="'.$elementname.'" ';
       if ($status ne 'single') {
           $form .= 'multiple="true" ';
       }
       $form .= 'size="'.$numvisible.'" >'."\n";
       #
       # Put in option for 'all'
       $form .= '    <option value="all" ';
       if ($selected_maps[0] eq 'all') {
           $form .= 'selected ';
       }
       $form .= ">all</option>\n";
       #
       # Loop through the sequences
       my @sequences = &selected_sequences_with_assessments('all');
       my $navmap;
       if (!ref($sequences[0])) {
           return $sequences[0];
       } else {
           $navmap = shift(@sequences);
       }
       foreach my $seq (@sequences){
           $form .= '    <option value="'.$seq->symb.'" ';
           foreach (@selected_maps) {
               if ($seq->symb eq $_) {
                   $form .= 'selected ';
                   last;
               }
         }          }
           $form .= '>'.$seq->compTitle."</option>\n";
     }      }
       $form .= "</select>\n";
       return $form;
   }
   
     $Str .= '</tr>'."\n";  ##############################################
     $Str .= '</table></td></tr></table>'."\n";  ##############################################
     $r->print($Str);  
     $r->rflush();  
   
     untie(%cache);  =pod 
   
     return;  =item &SectionSelect($elementname,$status,$numvisible) 
 }  
   
 sub CreateMainMenu {  Returns html for a selection box allowing the user to choose one (or more) 
     my ($status, $reports)=@_;  of the sections in the course.  
   
     my $Str = '';  Uses the package variables @Sections
   =over 4
   
     $Str .= '<table border="0"><tbody><tr>'."\n";  =item $elementname The name of the HTML form element
     $Str .= '<td></td><td></td>'."\n";  
     $Str .= '<td align="center"><b>Select a Report</b></td>'."\n";  
     $Str .= '<td align="center"><b>Student Status</b></td></tr>'."\n";  
     $Str .= '<tr>'."\n";  
     $Str .= '<td align="center"><input type="submit" name="Refresh" ';  
     $Str .= 'value="Refresh" /></td>'."\n";  
     $Str .= '<td align="center"><input type="submit" name="DownloadAll" ';  
     $Str .= 'value="Update All Student Data" /></td>'."\n";  
     $Str .= '<td align="center">';  
     $Str .= '<select name="reportSelected" onchange="document.';  
     $Str .= 'Statistics.submit()">'."\n";  
   
     foreach (sort(keys(%$reports))) {  
         next if($_ eq 'reportSelected');  
         $Str .= '<option name="'.$_.'"';  
         if($reports->{'reportSelected'} eq $reports->{$_}) {  
             $Str .= ' selected=""';  
         }  
         $Str .= '>'.$reports->{$_}.'</option>'."\n";  
     }  
     $Str .= '</select></td>'."\n";  
   
     $Str .= '<td align="center">';  
     $Str .= &Apache::lonhtmlcommon::StatusOptions($status, 'Statistics');  
     $Str .= '</td>'."\n";  
   
     $Str .= '</tr></tbody></table>'."\n";  =item $status 'multiple' or 'single' selection box
     $Str .= '<hr>'."\n";  
   
     return $Str;  =item $numvisible The number of options to be visible
 }  
   
 sub BuildStatistics {  =back
     my ($r)=@_;  
   =cut
   
     my $c = $r->connection;  ##############################################
     my @studentInformation=('fullname','section','id','domain','username',  ##############################################
                             'updateTime');  sub SectionSelect {
     my @headings=('Full Name', 'Section', 'PID', 'Domain', 'User Name',      my ($elementname,$status,$numvisible)=@_;
                   'Last Updated');      if ($numvisible < 1) {
     my $spacing = '   ';          return;
       }
     my %reports = ('classlist'          => 'Class list',      #
                    'problem_statistics' => 'Problem Statistics',      # Make sure we have the data we need to continue
                    'student_assessment' => 'Student Assessment',      if (! @Sections) {
    'percentage'         => 'Correct-problems Plot',          &PrepareClasslist()
 #                   'activitylog'        => 'Activity Log',      }
                    'reportSelected'     => 'Class list');      #
       # Build the form element
     my %cache;      my $Str = "\n";
     my $courseID=$ENV{'request.course.id'};      $Str .= '<select name="'.$elementname.'" ';
     my $cacheDB = "/home/httpd/perl/tmp/$ENV{'user.name'}".      if ($status ne 'single') {
                   "_$ENV{'user.domain'}_$courseID\_statistics.db";          $Str .= 'multiple="true" ';
       }
     $r->print(&Apache::lonhtmlcommon::Title('Course Statistics and Charts'));      $Str .= 'size="'.$numvisible.'" >'."\n";
       #
     my ($returnValue, $students) = &PrepareData($c, $cacheDB,      # Loop through the sequences
                                                 \@studentInformation,      foreach my $s (@Sections) {
                                                 \@headings,$r);          $Str .= '    <option value="'.$s.'" ';
     if($returnValue ne 'OK') {          foreach (&get_selected_sections()) {
         $r->print($returnValue."\n".'</body></html>');              if ($s eq $_) {
         return OK;                  $Str .= 'selected ';
     }                  last;
     if(!$c->aborted()) {              }
         &Apache::loncoursedata::CheckForResidualDownload($cacheDB,  
                                                          'true', 'true',  
                                                          $courseID,  
                                                          $r, $c);  
     }  
   
     my $GoToPage;  
     if(tie(%cache,'GDBM_File',$cacheDB,&GDBM_READER(),0640)) {  
         $GoToPage = $cache{'reportSelected'};  
         $reports{'reportSelected'} = $cache{'reportSelected'};  
         if(defined($cache{'reportKey'}) &&  
            !exists($reports{$cache{'reportKey'}}) &&  
            $cache{'reportKey'} ne 'false') {  
             $reports{$cache{'reportKey'}} = $cache{'reportSelected'};  
         }          }
           $Str .= '>'.$s."</option>\n";
       }
       $Str .= "</select>\n";
       return $Str;
   }
   
         if(defined($cache{'OptionResponses'})) {  ##############################################
             $reports{'problem_analysis'} = 'Option Response Analysis';  ##############################################
                                                                                       
   =pod
                                                                                       
   =item &GroupSelect($elementname,$status,$numvisible)
                                                                                       
   Returns html for a selection box allowing the user to choose one (or more)
   of the groups in the course.
                                                                                       
   Uses the package variables @Groups
   =over 4
                                                                                       
   =item $elementname The name of the HTML form element
                                                                                       
   =item $status 'multiple' or 'single' selection box
                                                                                       
   =item $numvisible The number of options to be visible
                                                                                       
   =back
                                                                                       
   =cut
                                                                                       
   ##############################################
   ##############################################
   sub GroupSelect {
       my ($elementname,$status,$numvisible)=@_;
       if ($numvisible < 1) {
           return;
       }
       #
       # Make sure we have the data we need to continue
       if (! @Groups) {
           &PrepareClasslist();
       }
       #
       # Build the form element
       my $Str = "\n";
       $Str .= '<select name="'.$elementname.'" ';
       if ($status ne 'single') {
           $Str .= 'multiple="true" ';
       }
       $Str .= 'size="'.$numvisible.'" >'."\n";
       #
       # Loop through the groups
       foreach my $s (@Groups) {
           $Str .= '    <option value="'.$s.'" ';
           foreach my $group (&get_selected_groups()) {
               if ($s eq $group) {
                   $Str .= 'selected ';
                   last;
               }
         }          }
           $Str .= '>'.$s."</option>\n";
       }
       $Str .= "</select>\n";
   }
   
         $r->print('<form name="Statistics" ');  
         $r->print('method="post" action="/adm/statistics">');  ##################################################
         $r->print(&CreateMainMenu($cache{'Status'}, \%reports));  ##################################################
   sub DisplayClasslist {
       my ($r)=@_;
       &Apache::lonhtmlcommon::add_breadcrumb
           ({text=>'Select One Student'});
       #
       # Output some of the standard interface components
       my $Str;
       $Str .= &Apache::lonhtmlcommon::breadcrumbs('Select One Student');
       $Str .= '<p><table cellspacing="5">'."\n";
       $Str .= '<tr>';
       $Str .= '<th align="center"><b>'.&mt('Sections').'</b></th>';
       $Str .= '<th align="center"><b>'.&mt('Groups').'</b></th>';
       $Str .= '<th align="center"><b>'.&mt('Access Status').'</b></th>';
       $Str .= '</tr>'.$/;
       $Str .= '<tr>';
       $Str .= '<td>'.
           &Apache::lonstatistics::SectionSelect('Section','multiple',5).
           '</td>';
       $Str .=  '<td>'.
           &Apache::lonstatistics::GroupSelect('Group','multiple',5).
           '</td>';
       $Str .= '<td>'.
           &Apache::lonhtmlcommon::StatusOptions(undef,undef,5).
           '</td>';
       
       $Str .= '</tr>'.$/;
       $Str .= '</table></p>';
       $Str .= '<input type="submit" name="selectstudent" value="'.
           &mt('Update Display').'" />';
       $r->print($Str);
       $r->rflush();
       #
       my @Fields = ('fullname','username','domain','id','section','status','groups');
       #
       $Str = '';
       my @selected_sections = &get_selected_sections();
       if (! @Students) {
           if ($selected_sections[0] eq 'all') { 
               if (lc($env{'form.Status'}) eq 'active') {
                   $Str .= '<p class="LC_info">'.
                   &mt('There are no currently enrolled students in the course.').
                       '</p>';
               } elsif (lc($env{'form.Status'}) eq 'expired') {
                   $Str .= '<p class="LC_info">'.
                       &mt('There are no previously enrolled students in the course.').
                           '</p>';
               } elsif (lc($env{'form.Status'}) eq 'future') {
                   $Str .= '<p class="LC_info">'.
                       &mt('There are no students with future access in the course.').
                           '</p>';
               } else { # 'any' and any others
                  $Str .= '<p class="LC_info">'.
                       &mt('There are no students in the course.').
                       '</p>';
               }
           } else { 
               if (lc($env{'form.Status'}) eq 'active') {
                   $Str .= '<p class="LC_info">'.
                       &mt('There are no currently enrolled students in the selected sections.').
                       '</p>';
               } elsif (lc($env{'form.Status'}) eq 'expired') {
                   $Str .= '<p class="LC_info">'.
                       &mt('There are no previously enrolled students in the selected sections.').
                       '</p>';
               } elsif (lc($env{'form.Status'}) eq 'future') {
                   $Str .= '<p class="LC_info">'.
                       &mt('There are no students with future access in the selected sections.').
                           '</p>';
               } else { # 'any' and any others
                   $Str .= '<p class="LC_info">'.
                       &mt('There are no students in the selected sections.').
                       '</p>';
               }
           }
           $Str.= '<p>'
                 .'<a href="/adm/statistics?reportSelected=student_assessment">'
                 .&mt('Return to the chart').'</a>'
                 .'</p>';
           $r->print($Str);
         $r->rflush();          $r->rflush();
         untie(%cache);          return;
     } else {  
         $r->print('<html><body>Unable to tie database.</body></html>');  
         return OK;  
     }      }
   
     if($GoToPage eq 'Activity Log') {      $Str .= '<h2>'.&mt('Select One Student').'</h2>'
         &Apache::lonproblemstatistics::Activity();             .'<p>'.&mt("Click on a student's name or username to view their chart").'</p>'
     } elsif($GoToPage eq 'Problem Statistics') {             .&Apache::loncommon::start_data_table()
         &Apache::lonproblemstatistics::BuildProblemStatisticsPage($cacheDB,             .&Apache::loncommon::start_data_table_header_row();
                                                                   $students,      foreach my $field (@Fields) {
                                                                   $courseID,          $Str .= '<th><a href="/adm/statistics?'.
                                                                   $c,$r);              'reportSelected=student_assessment&'.
     } elsif($GoToPage eq 'Option Response Analysis') {              'selectstudent=1&'.
         &Apache::lonproblemanalysis::BuildProblemAnalysisPage($cacheDB, $r);              'sort='.$field.'">'.&mt($field).
     } elsif($GoToPage eq 'Student Assessment') {              '</a></th>';
         &Apache::lonstudentassessment::BuildStudentAssessmentPage($cacheDB,  
                                                           $students,  
                                                           $courseID,  
                                                           'Statistics',  
                                                           \@headings,  
                                                           $spacing,  
                                                           \@studentInformation,  
                                                           $r, $c);  
     } elsif($GoToPage eq 'Analyze') {  
         &Apache::lonproblemanalysis::BuildAnalyzePage($cacheDB, $students,  
                                                       $courseID, $r);  
     } elsif($GoToPage eq 'DoDiffGraph' || $GoToPage eq 'PercentWrongGraph') {  
         my $courseDescription = $ENV{'course.'.$courseID.'.description'};  
         $courseDescription =~ s/\ /"_"/eg;  
         &Apache::lonproblemstatistics::BuildGraphicChart($GoToPage, $cacheDB,  
                                                          $courseDescription,  
                                                          $students, $courseID,  
                                                          $r, $c);  
     } elsif($GoToPage eq 'Class list') {  
         &BuildClasslist($cacheDB, $students, \@studentInformation,  
                         \@headings, $r);  
     } elsif($GoToPage eq 'Correct-problems Plot') {  
  &Apache::lonpercentage::BuildPercentageGraph($cacheDB, $students,  
      $courseID, $c, $r);  
     }      }
       $Str .= &Apache::loncommon::end_data_table_header_row();
     $r->print('</form>'."\n");      #
     $r->print("\n".'</body>'."\n".'</html>');      foreach my $student (@Students) { # @Students is a package variable
           my $sname = $student->{'username'}.':'.$student->{'domain'};
           $Str .= &Apache::loncommon::start_data_table_row();
           #
           foreach my $field (@Fields) {
               $Str .= '<td>';
               if ($field eq 'fullname' || $field eq 'username') {
                   $Str .= '<a href="/adm/statistics?reportSelected=';
                   $Str .= &escape('student_assessment');
                   $Str .= '&sort='.&escape($env{'form.sort'});
                   $Str .= '&SelectedStudent=';
                   $Str .= &escape($sname).'">';
                   $Str .= $student->{$field}.'&nbsp;';
                   $Str .= '</a>';
               } elsif ($field eq 'status') {
                   $Str .= &mt($student->{$field});
               } else {
                   $Str .= $student->{$field};
               }
               $Str .= '</td>';
           }
           $Str .= &Apache::loncommon::end_data_table_row();
       }
       $Str .= &Apache::loncommon::end_data_table();
       #
       $r->print($Str);
     $r->rflush();      $r->rflush();
       #
     return OK;      return;
 }  }
   
 # ================================================================ Main Handler  ##############################################
   ##############################################
   sub CreateMainMenu {
       #
       # Define menu data
       my @reports = ({ internal_name => 'problem_statistics',
                        name => &mt('Overall Problem Statistics'),
                        short_description => 
       &mt('Student performance statistics on all problems.'),
                    },
                      { internal_name => 'problem_analysis',
                        name => &mt('Detailed Problem Analysis'),
                        short_description => 
       &mt('Detailed statistics and graphs of student performance on problems.'),
                    },
                      { internal_name => 'submissiontime_analysis',
                        name => &mt('Submission Time Plots'),
                        short_description => 
       &mt('Display and analysis of submission times on assessments.'),
                    },
                      { internal_name => 'student_submission_reports',
                        name => &mt('Student Submission Reports'),
                        short_description => 
       &mt('Prepare reports of student submissions.'),
                    },
                      { internal_name => 'survey_reports',
                        name => &mt('Survey Reports'),
                        short_description => 
       &mt('Prepare reports on survey results.'),
                    },
                      { internal_name => 'correct_problems_plot',
                        name => &mt('Correct Problems Plot'),
                        short_description => 
       &mt('Display a histogram of student performance in the course.'),
                    },
   #                   { internal_name => 'grading_analysis',
   #                     name => &mt('Detailed Grading Analysis'),
   #                     short_description => 
   #    &mt('Display statistics about who graded who.'),
   #                 },
   #                   { internal_name => 'student_assessment',
   #                     name => &mt('Problem Status Chart'),
   #                     short_description => 
   #    &mt('Brief view of each students performance in course.'),
   #                 },
                      # 'percentage'  => 'Correct-problems Plot',
                      # 'activitylog' => 'Activity Log',
                      );
       #
       # Create the menu
       my $Str;
       $Str .= '<h2>'.&mt('Please select a report to generate').'</h2>';
       foreach my $reportdata (@reports) {
           $Str .='    <h3><a href="/adm/statistics?reportSelected='.
               $reportdata->{'internal_name'}.'" >'.
               $reportdata->{'name'}."</a></h3>\n";
           $Str .= '    '.('&nbsp;'x8).$reportdata->{'short_description'}.
               "\n";
       }
       $Str .="</dl>\n";
       #
       return $Str;
   }
   
   ##############################################
   ##############################################
 sub handler {  sub handler {
     my $r=shift;      my $r=shift;
       my $c = $r->connection();
 #    $jr = $r;      #
       # Check for overloading
     my $loaderror=&Apache::lonnet::overloaderror($r);      my $loaderror=&Apache::lonnet::overloaderror($r);
     if ($loaderror) { return $loaderror; }      if ($loaderror) { return $loaderror; }
     $loaderror=      $loaderror=
        &Apache::lonnet::overloaderror($r,         &Apache::lonnet::overloaderror($r,
          $ENV{'course.'.$ENV{'request.course.id'}.'.home'});           $env{'course.'.$env{'request.course.id'}.'.home'});
     if ($loaderror) { return $loaderror; }      if ($loaderror) { return $loaderror; }
       #
     unless(&Apache::lonnet::allowed('vgr',$ENV{'request.course.id'})) {      # Check for access
         $ENV{'user.error.msg'}=      if (! &Apache::lonnet::allowed('vgr',$env{'request.course.id'})) {
         $r->uri.":vgr:0:0:Cannot view grades for complete course";          $env{'user.error.msg'}=
         return HTTP_NOT_ACCEPTABLE;              $r->uri.":vgr:0:0:Cannot view grades for complete course";
     }          if (! &Apache::lonnet::allowed('vgr',
                         $env{'request.course.id'}.'/'.$env{'request.course.sec'})) {
     # Set document type for header only              $env{'user.error.msg'}=
     if($r->header_only) {                  $r->uri.":vgr:0:0:Cannot view grades with given role";
         if ($ENV{'browser.mathml'}) {              return HTTP_NOT_ACCEPTABLE;
             $r->content_type('text/xml');  
         } else {  
             $r->content_type('text/html');  
         }          }
         &Apache::loncommon::no_cache($r);  
         $r->send_http_header;  
         return OK;  
     }  
   
     unless($ENV{'request.course.fn'}) {  
  my $requrl=$r->uri;  
         $ENV{'user.error.msg'}="$requrl:bre:0:0:Course not initialized";  
         return HTTP_NOT_ACCEPTABLE;  
     }      }
       #
     $r->content_type('text/html');      # Send the header
       &Apache::loncommon::no_cache($r);
       &Apache::loncommon::content_type($r,'text/html');
     $r->send_http_header;      $r->send_http_header;
       if ($r->header_only) { return OK; }
     &PrepareClasslist($r);      #
       # Extract form elements from query string
     &BuildStatistics($r);      &Apache::loncommon::get_unprocessed_cgi($ENV{'QUERY_STRING'},
                                               ['sort','reportSelected',
                                                'SelectedStudent']);
       #
       # Give the LON-CAPA page header
       my $style = <<ENDSTYLE;
   <style type="text/css">
       ul.sub_studentans { list-style-type: none }
       ul.sub_correctans { list-style-type: none }
       tr.even           { background-color: \#CCCCCC }
       td.essay          { border: 1px solid gray; }
   </style>
   ENDSTYLE
         
       $r->print(&Apache::loncommon::start_page('Course Statistics and Charts',
        $style));
       $r->rflush();
       # 
       # Either print out a menu for them or send them to a report
       &Apache::lonhtmlcommon::clear_breadcrumbs();
       &Apache::lonhtmlcommon::add_breadcrumb({href=>'/adm/statistics',
                                               title=>'Statistics',
                                               text =>'Statistics',
                                               faq=>139,
                                               bug=>'Statistics and Charts'});
       if (! exists($env{'form.reportSelected'}) || 
           $env{'form.reportSelected'} eq '') {
           $r->print(&Apache::lonhtmlcommon::breadcrumbs('Statistics Main Page').
                     &CreateMainMenu());
       } else {
       #
           if (! &Apache::lonmysql::verify_sql_connection()) {
               my $serveradmin = $r->dir_config('lonAdmEMail');
               $r->print('<h2 class="LC_error">'.
                         &mt('Unable to connect to database!').
                         '</h2>');
               $r->print('<p>'
                        .&mt('Please notify the server administrator [_1]',
                            ,'<b>'.$serveradmin.'</b>')
                        .'</p>');
               $r->print('<p>'.
                         &mt('Course Statistics and Charts cannot be '.
                             'retrieved until the database is restarted.  '.
                             'Your data is intact but cannot be displayed '.
                             'at this time.').'</p>');
               $r->print(&Apache::loncommon::end_page());
               return;
           }
           #
           # Clean out the caches
           if (exists($env{'form.ClearCache'})) {
               &Apache::loncoursedata::delete_caches($env{'requres.course.id'});
           }
           #
           # Begin form output
           $r->print('<form name="Statistics" ');
           $r->print('method="post" action="/adm/statistics">');
           $r->rflush();
           #
           my $GoToPage = $env{'form.reportSelected'};
           #
           $r->print('<input type="hidden" name="reportSelected" value="'.
                     $GoToPage.'">');
           if($GoToPage eq 'activitylog') {
   #        &Apache::lonproblemstatistics::Activity();
           } elsif($GoToPage eq 'problem_statistics') {
               &Apache::lonhtmlcommon::add_breadcrumb
                   ({href=>'/adm/statistics?reportselected=problem_statistics',
                     text=>'Overall Problem Statistics'});
               &Apache::lonproblemstatistics::BuildProblemStatisticsPage($r,$c);
           } elsif($GoToPage eq 'problem_analysis') {
               &Apache::lonhtmlcommon::add_breadcrumb
                   ({href=>'/adm/statistics?reportselected=problem_analysis',
                     text=>'Detailed Problem Analysis'});
               &Apache::lonproblemanalysis::BuildProblemAnalysisPage($r,$c);
           } elsif($GoToPage eq 'submissiontime_analysis') {
               &Apache::lonhtmlcommon::add_breadcrumb
                   ({href=>
                         '/adm/statistics?reportselected=submissiontime_analysis',
                         text=>'Submission Time Plots'});
               &Apache::lonsubmissiontimeanalysis::BuildSubmissionTimePage($r,$c);
           } elsif($GoToPage eq 'student_submission_reports') {
               &Apache::lonhtmlcommon::add_breadcrumb
                   ({href=>
                     '/adm/statistics?reportselected=student_submission_reports',
                     text=>'Student Submission Reports'});
               &Apache::lonstudentsubmissions::BuildStudentSubmissionsPage($r,$c);
           } elsif($GoToPage eq 'survey_reports') {
               &Apache::lonhtmlcommon::add_breadcrumb
                   ({href=>
                     '/adm/statistics?reportselected=survey_reports',
                     text=>'Survey Reports'});
               &Apache::lonsurveyreports::BuildSurveyReportsPage($r,$c);
           } elsif($GoToPage eq 'correct_problems_plot') {
               &Apache::lonhtmlcommon::add_breadcrumb
                   ({href=>'/adm/statistics?reportselected=correct_problems_plot',
                     text=>'Correct Problems Plot'});
               &Apache::loncorrectproblemplot::BuildCorrectProblemsPage($r,$c);
           } elsif($GoToPage eq 'student_assessment') {
               &Apache::lonhtmlcommon::clear_breadcrumbs();
               &Apache::lonhtmlcommon::add_breadcrumb
                   ({href=>'/adm/statistics?reportselected=student_assessment',
                     text=>'Chart'});
               &Apache::lonstudentassessment::BuildStudentAssessmentPage($r,$c);
           } elsif($GoToPage eq 'grading_analysis') {
               &Apache::lonhtmlcommon::add_breadcrumb
                   ({href=>'/adm/statistics?reportselected=grading_anaylsis',
                     text=>'Grading Analysis'});
               &Apache::longradinganalysis::build_grading_analysis_page($r,$c);
    }
           #
           $r->print("</form>\n");
       }
       $r->print(&Apache::loncommon::end_page());
       $r->rflush();
       #
     return OK;      return OK;
 }  }
   
 1;  1;
   
   #######################################################
   #######################################################
   
 =pod  =pod
   
 =back  =back
   
 =cut  =cut
   
   #######################################################
   #######################################################
   
 __END__  __END__
   

Removed from v.1.59  
changed lines
  Added in v.1.142.2.1


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