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

Diff for /loncom/interface/lonstatistics.pm between versions 1.60 and 1.142

version 1.60, 2003/02/25 20:47:47 version 1.142, 2008/10/22 10:53:21
Line 38  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 61  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 vars qw/@FullClasslist @Students @Sections @SelectedSections  use Apache::longradinganalysis();
     $curr_student $prev_student $next_student   use LONCAPA;
     $top_map @Sequences @Assessments /;  
   
 #######################################################  #######################################################
 #######################################################  #######################################################
Line 89  use vars qw/@FullClasslist @Students @Se Line 91  use vars qw/@FullClasslist @Students @Se
   
 =item @Sections The sections available in this class  =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 $curr_student The student currently being examined
   
 =item $prev_student The student previous in the classlist  =item $prev_student The student previous in the classlist
Line 104  use vars qw/@FullClasslist @Students @Se Line 108  use vars qw/@FullClasslist @Students @Se
 #  #
 # Classlist variables  # Classlist variables
 #  #
 my @FullClasslist;  
 my @Students;  
 my @Sections;  
 my @SelectedSections;  
 my $curr_student;  my $curr_student;
 my $prev_student;  my $prev_student;
 my $next_student;  my $next_student;
Line 129  undef the following package variables: Line 129  undef the following package variables:
   
 =item @Sections  =item @Sections
   
 =item @SelectedSections  =item @Groups
   
   =item %StudentData
   
   =item @StudentDataOrder
   
   =item @SelectedStudentData
   
 =item $curr_student  =item $curr_student
   
Line 147  sub clear_classlist_variables { Line 153  sub clear_classlist_variables {
     undef(@FullClasslist);      undef(@FullClasslist);
     undef(@Students);      undef(@Students);
     undef(@Sections);      undef(@Sections);
     undef(@SelectedSections);      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 171  the following package variables: Line 179  the following package variables:
   
 =item @Sections  =item @Sections
   
 =item @SelectedSections  =item @Groups 
   
   =item %StudentData
   
   =item @SelectedStudentData
   
 =item $curr_student  =item $curr_student
   
Line 189  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);
     if (exists($ENV{'form.Section'})) {      my @selected_sections = &get_selected_sections();
         if (ref($ENV{'form.Section'})) {      my @selected_groups = &get_selected_groups();
             @SelectedSections = @$ENV{'form.Section'};      #
             # Remove the empty sections      # Deal with instructors with restricted section access
             for (my $i=0; $i<=$#SelectedSections; $i++) {      if ($env{'request.course.sec'} !~ /^\s*$/) {
                 if ($SelectedSections[$i] =~ /^\s*$/) {          @selected_sections = ($env{'request.course.sec'});
                     splice(@SelectedSections,$i,1);  
                 }  
             }  
         } else {  
             if ($ENV{'form.Section'} !~ /^\s*$/) {  
                 @SelectedSections = ($ENV{'form.Section'});  
             }  
         }  
     }      }
     @SelectedSections = ('any') if (! @SelectedSections);  
     #      #
       # 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);
         #          #
Line 233  sub PrepareClasslist { Line 277  sub PrepareClasslist {
         $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
         foreach my $sect (@SelectedSections) {          foreach my $sect (@selected_sections) {
             if (($sect eq 'any') || ($section eq $sect)) {              if ( (($sect eq 'all') || 
                 push (@Students,$studenthash);                    ($section eq $sect)) &&
                 last;                   (($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;
                       }
                   }
             }              }
         }          }
     }      }
     #      #
     # Put the consolidated section data in the right place      # Put the consolidated section data in the right place
     @Sections = sort {$a cmp $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';
     $sortby = $ENV{'form.sort'} if (exists($ENV{'form.sort'}));      $sortby = $env{'form.sort'} if (exists($env{'form.sort'}));
     my @TmpStudents = sort { $a->{$sortby} cmp $b->{$sortby} ||      my @TmpStudents = sort { lc($a->{$sortby}) cmp lc($b->{$sortby}) ||
                              $a->{'fullname'} cmp $b->{'fullname'} } @Students;                               lc($a->{'fullname'}) cmp lc($b->{'fullname'}) ||
        lc($a->{'username'}) cmp lc($b->{'username'}) } @Students;
     @Students = @TmpStudents;      @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) || 
Line 263  sub PrepareClasslist { Line 344  sub PrepareClasslist {
             $curr_student = $Students[$i];              $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;
 }  }
   
 #######################################################  #######################################################
 #######################################################  #######################################################
 #  
 # Course Sequences variables  =pod
 #  
 my $top_map;  =item get_selected_sections
 my @Sequences;  
 my @Assessments;  Returns an array of the selected sections
   
   =cut
   
 #######################################################  #######################################################
 #######################################################  #######################################################
   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;
   }
   
   #######################################################
   #######################################################
                                                                                       
   =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  =pod
   
 =item &clear_sequence_variables()  =item &section_and_enrollment_description
   
   Returns a string describing the currently selected section(s), group(s) and 
   access status.  
   
   Inputs: mode = 'plaintext' or 'localized'  (defaults to 'localized')
       'plaintext' is used for example in Excel spreadsheets.
   Returns: scalar description string.
   
 =cut  =cut
   
 #######################################################  #######################################################
 #######################################################  #######################################################
 sub clear_sequence_variables {  sub section_and_enrollment_description {
     undef($top_map);      my ($mode) = @_;
     undef(@Sequences);      if (! defined($mode)) { $mode = 'localized'; }
     undef(@Assessments);      my @sections = &Apache::lonstatistics::get_selected_sections();
       my @groups = &Apache::lonstatistics::get_selected_groups();
       my $description;
       if ($mode eq 'localized') {
           $description = &mt('Unable to determine section, groups and access status');
       } elsif ($mode eq 'plaintext') {
           $description = 'Unable to determine section, groups and access status';
       } else {
           $description = 'Bad parameter passed to lonstatistics::section_and_enrollment_description';
           &Apache::lonnet::logthis($description);
       }
       $description = &section_or_group_text($mode,'section',@sections).
    ' '.&section_or_group_text($mode,'group',@groups);
       if ($mode eq 'localized') {
           $description .= ' '.&mt($env{'form.Status'}.' access status.');
       } elsif ($mode eq 'plaintext') {
           $description .= ' '.$env{'form.Status'}.' access status.';
       }
       return $description;
 }  }
   
 #######################################################  #######################################################
 #######################################################  #######################################################
   
   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 &PrepareCourseData($r)  =item get_students
   
   Returns a list of the selected students
   
 =cut  =cut
   
 #######################################################  #######################################################
 #######################################################  #######################################################
 sub PrepareCourseData {  sub get_students {
     my ($r) = @_;      if (! @Students) {
     &clear_sequence_variables();          &PrepareClasslist()
     my ($top,$sequences,$assessments) = &Apache::loncoursedata::get_sequence_assessment_data();  
     if (! defined($top) || ! ref($top)) {  
         # There has been an error, better report it  
         &Apache::lonnet::logthis('top is undefined');  
         return;  
     }      }
     $top_map = $top if (ref($top));      return @Students;
     @Sequences = @{$sequences} if (ref($sequences) eq 'ARRAY');  }
     @Assessments = @{$assessments} if (ref($assessments) eq 'HASH');  
   #######################################################
   #######################################################
   
 =pod  =pod
   
     ##  =item &current_student()
     ## Debugging code  
     ##  Returns a pointer to a hash containing data about the currently
     foreach my $s (@Sequences) {  selected student.
         next if ($s->{'title'} ne 'Bioenergetics: Enzyme Regulation');  
         &Apache::lonnet::logthis('-----------------------------------');  
         &Apache::lonnet::logthis('title      = '.$s->{'title'});  
         &Apache::lonnet::logthis('symb       = '.$s->{'symb'});  
         &Apache::lonnet::logthis('num_assess = '.$s->{'num_assess'});  
         foreach my $a (@{$s->{'contents'}}) {  
             &Apache::lonnet::logthis('   --------------------------------');  
             &Apache::lonnet::logthis('   title      = '.$a->{'title'});  
             &Apache::lonnet::logthis('   symb       = '.$a->{'symb'});  
         }  
     }  
   
 =cut  =cut
   
     return;  #######################################################
   #######################################################
   sub current_student { 
       return $curr_student;
 }  }
   
 ##############################################  #######################################################
 ##############################################  #######################################################
   
 =pod   
   
 =item &MapSelect($elementname,$status,$numvisible,$selected,$restriction)   =pod
   
 Returns html for a selection box allowing the user to choose one (or more)   =item &previous_student()
 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.  
   
 =over 4  Returns a pointer to a hash containing data about the student prior
   in the list of students.  Or something.  
   
 =item $elementname The name of the HTML form element  =cut
   
 =item $status 'multiple' or 'single' selection box  #######################################################
   #######################################################
   sub previous_student { 
       return $prev_student;
   }
   
 =item $numvisible The number of options to be visible  #######################################################
   #######################################################
   
 =item $selected Array ref to the names of the already selected maps.  =pod
 If undef, $ENV{'form.'.$elementname} is used.    
 If $ENV{'form.'.$elementname} is also empty, none will be selected.  
   
 =item $restriction Code reference to subroutine which returns true or   =item &next_student()
 false.  The code must expect a reference to a sequence data structure.  
   
 =back  Returns a pointer to a hash containing data about the next student
   to be viewed.
   
 =cut  =cut
   
 ##############################################  #######################################################
 ##############################################  #######################################################
 sub MapSelect {  sub next_student { 
     my ($elementname,$status,$numvisible,$selected,$restriction)=@_;      return $next_student;
     if ($numvisible < 1) {  
         return;  
     }  
     #  
     # Set up array of selected items  
     my @Selected;  
     if (! defined($selected)) {  
         if (exists($ENV{'form.'.$elementname})) {  
             if (ref($ENV{'form.'.$elementname})) {  
                 @Selected = @$ENV{'form.'.$elementname};  
             } else {  
                 @Selected = ($ENV{'form.'.$elementname});  
             }  
         } else {  
             @Selected = ();  
         }  
     } else {  
         if (ref($selected)) {  
             @Selected = @$selected;  
         } else {  
             @Selected = ($selected);  
         }  
     }  
     #  
     # Set up the restriction call  
     if (! defined($restriction)) {  
         $restriction = sub { 1; };  
     }  
     #  
     # 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 sequences  
     foreach my $s (@Sequences) {  
         next if (! $restriction->($s));  
         $Str .= '    <option value="'.$s->{'symb'}.'" ';  
         foreach (@Selected) {  
             if ($s->{'symb'} eq $_) {  
                 $Str .= 'selected ';  
                 last;  
             }  
         }  
         $Str .= '>'.$s->{'title'}."</option>\n";  
     }  
     $Str .= "</select>\n";  
     return $Str;  
 }  }
   
   
 ##############################################  ##############################################
 ##############################################  ##############################################
   
 =pod   =pod 
   
 =item &SectionSelect($elementname,$status,$numvisible)   =item &StudentDataSelect($elementname,$status,$numvisible,$selected)
   
 Returns html for a selection box allowing the user to choose one (or more)   Returns html for a selection box allowing the user to choose one (or more) 
 of the sections in the course.    of the fields of student data available (fullname, username, id, section, etc)
   
 =over 4  =over 4
   
Line 455  of the sections in the course. Line 602  of the sections in the course.
   
 =item $numvisible The number of options to be visible  =item $numvisible The number of options to be visible
   
 =item $selected Array ref to the names of the already selected sections.  
 If undef, $ENV{'form.'.$elementname} is used.    
 If $ENV{'form.'.$elementname} is also empty, none will be selected.  
   
 =item $restriction Code reference to subroutine which returns true or   
 false.  The code must expect a reference to a sequence data structure.  
   
 =back  =back
   
 =cut  =cut
   
 ##############################################  ##############################################
 ##############################################  ##############################################
 sub SectionSelect {  sub StudentDataSelect {
     my ($elementname,$status,$numvisible)=@_;      my ($elementname,$status,$numvisible)=@_;
     if ($numvisible < 1) {      if ($numvisible < 1) {
         return;          return;
Line 482  sub SectionSelect { Line 622  sub SectionSelect {
     }      }
     $Str .= 'size="'.$numvisible.'" >'."\n";      $Str .= 'size="'.$numvisible.'" >'."\n";
     #      #
     # Loop through the sequences      # Deal with 'all'
     foreach my $s (@Sections) {      $Str .= '    <option value="all" ';
         $Str .= '    <option value="'.$s.'" ';      foreach (@SelectedStudentData) {
         foreach (@SelectedSections) {          if ($_ eq 'all') {
             if ($s eq $_ || $_ =~ /^(any|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 ';                  $Str .= 'selected ';
                 last;                  last;
             }              }
         }          }
         $Str .= '>'.$s."</option>\n";          $Str .= '>'.$item."</option>\n";
     }      }
     $Str .= "</select>\n";      $Str .= "</select>\n";
     return $Str;      return $Str;
 }  }
   
 ##############################################  #######################################################
 ##############################################  #######################################################
   
 sub CheckFormElement {  =pod
     my ($cache, $ENVName, $cacheName, $default)=@_;  
   
     if(defined($ENV{'form.'.$ENVName})) {  =item &get_selected_maps($elementname)
         $cache->{$cacheName} = $ENV{'form.'.$ENVName};  
     } elsif(!defined($cache->{$cacheName})) {  
         $cache->{$cacheName} = $default;  
     } else {  
         $ENV{'form.'.$ENVName} = $cache->{$cacheName};  
     }  
     return;  
 }  
   
 sub ProcessFormData{  Input: Name of the <select> form element used to specify the maps.
     my ($cache)=@_;  
   
     $cache->{'reportKey'} = 'false';  Returns: Array of symbs of selected maps or the description 'all'.
      If form.$elementname does not exist, 'all' is returned.
   
     &Apache::loncommon::get_unprocessed_cgi($ENV{'QUERY_STRING'},  =cut
                                             ['download',  
                                              'reportSelected',  
                                              'StudentAssessmentStudent',  
                                              'ProblemStatisticsSort']);  
     &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 :( )  
         # So, remove every single key.  What a waste of time....  
         # Of course, if you are doing this you are probably resigned  
         # to waiting a while.  
         &Apache::lonnet::logthis("Cleaning out the cache file");  
         while (my ($key,undef)=each(%$cache)) {  
             next if ($key eq 'DownloadAll');  
             delete($cache->{$key});  
         }  
     }  
     &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 {  
         $cache->{'StudentAssessmentMove'} = 'selected';  
     }  
     &CheckFormElement($cache, 'StudentAssessmentStudent',   
                       'StudentAssessmentStudent', 'All Students');  
     $cache->{'StudentAssessmentStudent'} =   
         &Apache::lonnet::unescape($cache->{'StudentAssessmentStudent'});  
     &CheckFormElement($cache, 'DefaultColumns', 'DefaultColumns', 'false');  
   
     # 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';  sub get_selected_maps {
     } elsif($cache->{'reportSelected'} eq 'DoDiffGraph') {      my ($elementname) = @_;
         $cache->{'reportKey'} = 'DoDiffGraph';      my @selected_maps = 
     } elsif($cache->{'reportSelected'} eq 'PercentWrongGraph') {   &Apache::loncommon::get_env_multiple('form.'.$elementname);
         $cache->{'reportKey'} = 'PercentWrongGraph';      @selected_maps = ('all') if (! @selected_maps);
     }      foreach my $map (@selected_maps) {
           if ($map eq 'all') {
     if(defined($ENV{'form.DoDiffGraph'})) {              @selected_maps = ('all');
         $cache->{'reportSelected'} = 'DoDiffGraph';              last;
         $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;  
         }          }
     }      }
       return @selected_maps;
     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;  
 }  }
   
 =pod  
   
 =item &SortStudents()  
   
 Determines which students to display and in which order.  Which are   
 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  #######################################################
   #######################################################
 Input: $students, $CacheData  
   
 $students: A array pointer to a list of students (username:domain)  =pod
   
 $CacheData: A pointer to the hash tied to the cached data  =item &selected_sequences_with_assessments
   
 Output: \@order  Retrieve the sequences which were selected by the user to show.  
   
 @order: An ordered list of students (username:domain)  Input: $mode: scalar.  Either 'selected' or 'all'.  If not specified,
       'selected' is used.
   
 =back  Returns: an array containing a navmap object and navmap resources, 
       or an array containing a scalar with an error message.
   
 =cut  =cut
   
 sub SortStudents {  #######################################################
     my ($cache)=@_;  #######################################################
   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 @students = split(':::',$cache->{'NamesOfStudents'});      my @sequences_with_assessments;
     my @sorted1Students=();      foreach my $sequence (@sequences) {
     foreach (@students) {   if ($navmap->hasResource($sequence,sub { shift->is_problem(); },0,1)){
         if($cache->{'Status'} eq 'Any' ||               push(@sequences_with_assessments,$sequence);
            $cache->{$_.':Status'} eq $cache->{'Status'}) {  
             push(@sorted1Students, $_);  
         }          }
     }      }
       #
       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
                   }
               }
           }
   
     my $sortBy = '';  
     if(defined($cache->{'sort'})) {  
         $sortBy = ':'.$cache->{'sort'};  
     } else {  
         $sortBy = ':fullname';  
     }      }
     my @order = sort { lc($cache->{$a.$sortBy}) cmp lc($cache->{$b.$sortBy}) ||      return $navmap,@sequences_to_show;
                        lc($cache->{$a.':fullname'}) cmp lc($cache->{$b.':fullname'}) }   
                 @sorted1Students;  
   
     return \@order;  
 }  }
   
 =pod  ##############################################
   ##############################################
 =item &SpaceColumns()  
   
 Determines the width of all the columns in the chart.  It is based on  
 the max of the data for that column and its header.  
   
 =over 4  =pod 
   
 Input: $students, $studentInformation, $headings, $ChartDB  =item &map_select($elementname,$status,$numvisible,$restriction) 
   
 $students: An array pointer to a list of students (username:domain)  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.
   
 $studentInformatin: The type of data for the student information.  It is  =over 4
 used as part of the key in $CacheData.  
   
 $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 map_select {
     # 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;      #
     }      # Set up array of selected items
       my @selected_maps = &get_selected_maps($elementname);
     foreach my $name (@$students) {      #
         foreach (@$studentInformation) {      # Build the form element
             my @dataLength=split(//,$cache->{$name.':'.$_});      my $form = "\n";
             my $length=(scalar @dataLength);      $form .= '<select name="'.$elementname.'" ';
             if($length > $cache->{$_.':columnWidth'}) {      if ($status ne 'single') {
                 $cache->{$_.':columnWidth'}=$length;          $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;      return $form;
 }  }
   
 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 &SectionSelect($elementname,$status,$numvisible) 
                                                          $isRecalculate);  
     if($isCached < 0) {  
         return "Unable to tie hash to db file.";  
     }  
   
     # Download class list information if not using cached data  Returns html for a selection box allowing the user to choose one (or more) 
     my %cache;  of the sections in the course.  
     unless(tie(%cache,'GDBM_File',$cacheDB,&GDBM_WRCREAT(),0640)) {  
         return "Unable to tie hash to db file.";  
     }  
   
 #    if(!$isCached) {  Uses the package variables @Sections
         my $processTopResourceMapReturn=  =over 4
             &Apache::loncoursedata::ProcessTopResourceMap(\%cache, $c);  
         if($processTopResourceMapReturn ne 'OK') {  
             untie(%cache);  
             return $processTopResourceMapReturn;  
         }  
  #   }  
   
     if($c->aborted()) {  =item $elementname The name of the HTML form element
         untie(%cache);  
         return 'aborted';   
     }  
   
     my $classlist=&Apache::loncoursedata::DownloadClasslist($courseID,  =item $status 'multiple' or 'single' selection box
                                                 $cache{'ClasslistTimestamp'},  
                                                 $c);  
     foreach (keys(%$classlist)) {  
         if(/^(con_lost|error|no_such_host)/i) {  
             untie(%cache);  
             return "Error getting student data.";  
         }  
     }  
   
     if($c->aborted()) {  =item $numvisible The number of options to be visible
         untie(%cache);  
         return 'aborted';   
     }  
   
     # Active is a temporary solution, remember to change  =back
     Apache::loncoursedata::ProcessClasslist(\%cache,$classlist,$courseID,$c);  
     if($c->aborted()) {  
         untie(%cache);  
         return 'aborted';   
     }  
   
     &ProcessFormData(\%cache);  =cut
     my $students = &SortStudents(\%cache);  
     &SpaceColumns($students, $studentInformation, $headings, \%cache);  
     $cache{'updateTime:columnWidth'}=24;  
   
     my $download = $cache{'download'};  ##############################################
     my $downloadAll = $cache{'DownloadAll'};  ##############################################
     my @allStudents=();  sub SectionSelect {
     if($download ne 'false') {      my ($elementname,$status,$numvisible)=@_;
         $cache{'download'} = 'false';      if ($numvisible < 1) {
     } elsif($downloadAll ne 'false') {          return;
         $cache{'DownloadAll'} = 'false';      }
         if($downloadAll eq 'sorted') {      #
             @allStudents = @$students;      # Make sure we have the data we need to continue
         } else {      if (! @Sections) {
             @allStudents = split(':::', $cache{'NamesOfStudents'});          &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 sequences
       foreach my $s (@Sections) {
           $Str .= '    <option value="'.$s.'" ';
           foreach (&get_selected_sections()) {
               if ($s eq $_) {
                   $Str .= 'selected ';
                   last;
               }
         }          }
           $Str .= '>'.$s."</option>\n";
     }      }
       $Str .= "</select>\n";
       return $Str;
   }
   
     untie(%cache);  ##############################################
   ##############################################
     if($download ne 'false') {                                                                                      
         my @who = ($download);  =pod
         if(&Apache::loncoursedata::DownloadStudentCourseData(\@who, 'false',                                                                                      
                                                              $cacheDB, 'true',  =item &GroupSelect($elementname,$status,$numvisible)
                                                              'false', $courseID,                                                                                      
                                                              $r, $c) ne 'OK') {  Returns html for a selection box allowing the user to choose one (or more)
             return 'Stop at download individual';  of the groups in the course.
         }                                                                                      
     } elsif($downloadAll ne 'false') {  Uses the package variables @Groups
         if(&Apache::loncoursedata::DownloadStudentCourseData(\@allStudents,  =over 4
                                                              'false',                                                                                      
                                                              $cacheDB, 'true',  =item $elementname The name of the HTML form element
                                                              'true', $courseID,                                                                                      
                                                              $r, $c) ne 'OK') {  =item $status 'multiple' or 'single' selection box
             return 'Stop at download all';                                                                                      
   =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";
     return ('OK', $students);  
 }  }
   
   
   ##################################################
   ##################################################
 sub DisplayClasslist {  sub DisplayClasslist {
     my ($r)=@_;      my ($r)=@_;
       &Apache::lonhtmlcommon::add_breadcrumb
           ({text=>'Select One Student'});
     #      #
     my @Fields = ('fullname','username','domain','id','section');      # 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 $Str='';      my @Fields = ('fullname','username','domain','id','section','status','groups');
     $Str .= '<table border="0"><tr><td bgcolor="#777777">'."\n";      #
     $Str .= '<table border="0" cellpadding="3"><tr bgcolor="#e6ffff">'."\n";      $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();
           return;
       }
   
       $Str .= '<h2>'.&mt('Select One Student').'</h2>'
              .'<p>'.&mt("Click on a student's name or username to view their chart").'</p>'
              .&Apache::loncommon::start_data_table()
              .&Apache::loncommon::start_data_table_header_row();
     foreach my $field (@Fields) {      foreach my $field (@Fields) {
         $Str .= '<th><a href="/adm/statistics?sort='.$field.'">'.$field.          $Str .= '<th><a href="/adm/statistics?'.
               'reportSelected=student_assessment&'.
               'selectstudent=1&'.
               'sort='.$field.'">'.&mt($field).
             '</a></th>';              '</a></th>';
     }      }
     $Str .= '</tr>'."\n";      $Str .= &Apache::loncommon::end_data_table_header_row();
     #      #
     my $alternate = 0;      foreach my $student (@Students) { # @Students is a package variable
     foreach my $student (@Students) {  
         my $sname = $student->{'username'}.':'.$student->{'domain'};          my $sname = $student->{'username'}.':'.$student->{'domain'};
         if($alternate) {          $Str .= &Apache::loncommon::start_data_table_row();
             $Str .= '<tr bgcolor="#ffffe6">';  
         } else {  
             $Str .= '<tr bgcolor="#ffffc6">';  
         }  
         $alternate = ($alternate + 1) % 2;  
         #          #
         foreach my $field (@Fields) {          foreach my $field (@Fields) {
             $Str .= '<td>';              $Str .= '<td>';
             if ($field eq 'fullname') {              if ($field eq 'fullname' || $field eq 'username') {
                 $Str .= '<a href="/adm/statistics?reportSelected=';                  $Str .= '<a href="/adm/statistics?reportSelected=';
                 $Str .= &Apache::lonnet::escape('Student Assessment');                  $Str .= &escape('student_assessment');
                 $Str .= '&StudentAssessmentStudent=';                  $Str .= '&sort='.&escape($env{'form.sort'});
                 $Str .= &Apache::lonnet::escape($student->{$field}).'">';                  $Str .= '&SelectedStudent=';
                   $Str .= &escape($sname).'">';
                 $Str .= $student->{$field}.'&nbsp';                  $Str .= $student->{$field}.'&nbsp';
                 $Str .= '</a>';                  $Str .= '</a>';
               } elsif ($field eq 'status') {
                   $Str .= &mt($student->{$field});
             } else {              } else {
                 $Str .= $student->{$field};                  $Str .= $student->{$field};
             }              }
             $Str .= '</td>';              $Str .= '</td>';
         }          }
         $Str .= "</tr>\n";          $Str .= &Apache::loncommon::end_data_table_row();
     }      }
     $Str .= '</table></td></tr></table>'."\n";      $Str .= &Apache::loncommon::end_data_table();
     #      #
     $r->print($Str);      $r->print($Str);
     $r->rflush();      $r->rflush();
Line 913  sub DisplayClasslist { Line 1054  sub DisplayClasslist {
     return;      return;
 }  }
   
 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";  
         }  
     }  
   
     $Str .= '</tr>'."\n";  
     $Str .= '</table></td></tr></table>'."\n";  
     $r->print($Str);  
     $r->rflush();  
   
     untie(%cache);  
   
     return;  
 }  
   
 sub CreateMainMenu {  sub CreateMainMenu {
     my ($status, $reports)=@_;      #
       # Define menu data
     my $Str = '';      my @reports = ({ internal_name => 'problem_statistics',
                        name => &mt('Overall Problem Statistics'),
     $Str .= '<table border="0"><tbody><tr>'."\n";                       short_description => 
     $Str .= '<td></td><td></td>'."\n";      &mt('Student performance statistics on all problems.'),
     $Str .= '<td align="center"><b>Select a Report</b></td>'."\n";                   },
     $Str .= '<td align="center"><b>Student Status</b></td></tr>'."\n";                     { internal_name => 'problem_analysis',
     $Str .= '<tr>'."\n";                       name => &mt('Detailed Problem Analysis'),
     $Str .= '<td align="center"><input type="submit" name="Refresh" ';                       short_description => 
     $Str .= 'value="Refresh" /></td>'."\n";      &mt('Detailed statistics and graphs of student performance on problems.'),
     $Str .= '<td align="center"><input type="submit" name="DownloadAll" ';                   },
     $Str .= 'value="Update All Student Data" /></td>'."\n";                     { internal_name => 'submissiontime_analysis',
     $Str .= '<td align="center">';                       name => &mt('Submission Time Plots'),
     $Str .= '<select name="reportSelected" onchange="document.';                       short_description => 
     $Str .= 'Statistics.submit()">'."\n";      &mt('Display and analysis of submission times on assessments.'),
                    },
     foreach (sort(keys(%$reports))) {                     { internal_name => 'student_submission_reports',
         next if($_ eq 'reportSelected');                       name => &mt('Student Submission Reports'),
         $Str .= '<option name="'.$_.'"';                       short_description => 
         if($reports->{'reportSelected'} eq $reports->{$_}) {      &mt('Prepare reports of student submissions.'),
             $Str .= ' selected=""';                   },
         }                     { internal_name => 'survey_reports',
         $Str .= '>'.$reports->{$_}.'</option>'."\n";                       name => &mt('Survey Reports'),
     }                       short_description => 
     $Str .= '</select></td>'."\n";      &mt('Prepare reports on survey results.'),
                    },
     $Str .= '<td align="center">';                     { internal_name => 'correct_problems_plot',
     $Str .= &Apache::lonhtmlcommon::StatusOptions($status, 'Statistics');                       name => &mt('Correct Problems Plot'),
     $Str .= '</td>'."\n";                       short_description => 
       &mt('Display a histogram of student performance in the course.'),
     $Str .= '</tr></tbody></table>'."\n";                   },
     $Str .= '<hr>'."\n";  #                   { internal_name => 'grading_analysis',
   #                     name => &mt('Detailed Grading Analysis'),
     return $Str;  #                     short_description => 
 }  #    &mt('Display statistics about who graded who.'),
   #                 },
 sub BuildStatistics {  #                   { internal_name => 'student_assessment',
     my ($r)=@_;  #                     name => &mt('Problem Status Chart'),
   #                     short_description => 
     my $c = $r->connection;  #    &mt('Brief view of each students performance in course.'),
     my @studentInformation=('fullname','section','id','domain','username',  #                 },
                             'updateTime');                     # 'percentage'  => 'Correct-problems Plot',
     my @headings=('Full Name', 'Section', 'PID', 'Domain', 'User Name',                     # 'activitylog' => 'Activity Log',
                   'Last Updated');                     );
     my $spacing = '   ';      #
       # Create the menu
     my %reports = ('classlist'          => 'Class list',      my $Str;
                    'problem_statistics' => 'Problem Statistics',      $Str .= '<h2>'.&mt('Please select a report to generate').'</h2>';
                    'student_assessment' => 'Student Assessment',      foreach my $reportdata (@reports) {
    'percentage'         => 'Correct-problems Plot',          $Str .='    <h3><a href="/adm/statistics?reportSelected='.
 #                   'activitylog'        => 'Activity Log',              $reportdata->{'internal_name'}.'" >'.
                    'reportSelected'     => 'Class list');              $reportdata->{'name'}."</a></h3>\n";
           $Str .= '    '.('&nbsp;'x8).$reportdata->{'short_description'}.
     my %cache;              "\n";
     my $courseID=$ENV{'request.course.id'};  
     my $cacheDB = "/home/httpd/perl/tmp/$ENV{'user.name'}".  
                   "_$ENV{'user.domain'}_$courseID\_statistics.db";  
   
     $r->print(&Apache::lonhtmlcommon::Title('Course Statistics and Charts'));  
   
     my ($returnValue, $students) = &PrepareData($c, $cacheDB,  
                                                 \@studentInformation,  
                                                 \@headings,$r);  
     if($returnValue ne 'OK') {  
         $r->print($returnValue."\n".'</body></html>');  
         return OK;  
     }  
     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'};  
         }  
   
         if(defined($cache{'OptionResponses'})) {  
             $reports{'problem_analysis'} = 'Option Response Analysis';  
         }  
   
         $r->print('<form name="Statistics" ');  
         $r->print('method="post" action="/adm/statistics">');  
         $r->print(&CreateMainMenu($cache{'Status'}, \%reports));  
         $r->rflush();  
         untie(%cache);  
     } else {  
         $r->print('<html><body>Unable to tie database.</body></html>');  
         return OK;  
     }  
   
     if($GoToPage eq 'Activity Log') {  
         &Apache::lonproblemstatistics::Activity();  
     } elsif($GoToPage eq 'Problem Statistics') {  
         &Apache::lonproblemstatistics::BuildProblemStatisticsPage($cacheDB,  
                                                                   $students,  
                                                                   $courseID,  
                                                                   $c,$r);  
     } elsif($GoToPage eq 'Option Response Analysis') {  
         &Apache::lonproblemanalysis::BuildProblemAnalysisPage($cacheDB, $r);  
     } elsif($GoToPage eq 'Student Assessment') {  
         &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') {  
         &DisplayClasslist($r);  
 #        &BuildClasslist($cacheDB, $students, \@studentInformation,  
 #                        \@headings, $r);  
     } elsif($GoToPage eq 'Correct-problems Plot') {  
  &Apache::lonpercentage::BuildPercentageGraph($cacheDB, $students,  
      $courseID, $c, $r);  
     }      }
       $Str .="</dl>\n";
     $r->print('</form>'."\n");      #
     $r->print("\n".'</body>'."\n".'</html>');      return $Str;
     $r->rflush();  
   
     return OK;  
 }  }
   
 # ================================================================ Main Handler  ##############################################
   ##############################################
 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'}) {      # Send the header
  my $requrl=$r->uri;      &Apache::loncommon::no_cache($r);
         $ENV{'user.error.msg'}="$requrl:bre:0:0:Course not initialized";      &Apache::loncommon::content_type($r,'text/html');
         return HTTP_NOT_ACCEPTABLE;  
     }  
   
     $r->content_type('text/html');  
     $r->send_http_header;      $r->send_http_header;
       if ($r->header_only) { return OK; }
       #
       # Extract form elements from query string
     &Apache::loncommon::get_unprocessed_cgi($ENV{'QUERY_STRING'},      &Apache::loncommon::get_unprocessed_cgi($ENV{'QUERY_STRING'},
                                             ['sort']);                                              ['sort','reportSelected',
                                                'SelectedStudent']);
     &PrepareClasslist($r);      #
       # Give the LON-CAPA page header
     &PrepareCourseData($r);      my $style = <<ENDSTYLE;
   <style type="text/css">
     &BuildStatistics($r);      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.60  
changed lines
  Added in v.1.142

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