Diff for /loncom/interface/lonstatistics.pm between versions 1.32 and 1.78.2.2

version 1.32, 2002/07/25 21:23:51 version 1.78.2.2, 2003/10/03 15:40:47
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  Behrouz Minaei  
 #  #
 ###  ###
   
 package Apache::lonstatistics;   =pod
   
   =head1 NAME
   
   lonstatistics
   
   =head1 SYNOPSIS
   
   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 Apache::lonmysql;
   =over 4
   
   =cut
   
   package Apache::lonstatistics;
   
 use strict;  use strict;
 use Apache::Constants qw(:common :http);  use Apache::Constants qw(:common :http);
   use vars qw(
       @FullClasslist 
       @Students
       @Sections 
       @SelectedSections
       %StudentData
       @StudentDataOrder
       @SelectedStudentData
       $top_map 
       @Sequences 
       @SelectedMaps
       @Assessments);
   
 use Apache::lonnet();  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::lonproblemanalysis();
 use Apache::lonproblemstatistics;  use Apache::lonproblemstatistics();
 use Apache::lonstudentassessment;  use Apache::lonstudentassessment();
 use Apache::lonchart;  use Apache::lonpercentage;
 use HTML::TokeParser;  use Apache::lonmysql;
 use GDBM_File;  use Time::HiRes;
   
   #######################################################
   #######################################################
   
 sub CheckFormElement {  =pod
     my ($cache, $ENVName, $cacheName, $default)=@_;  
   
     if(defined($ENV{'form.'.$ENVName})) {  
         $cache->{$cacheName} = $ENV{'form.'.$ENVName};  
     } elsif(!defined($cache->{$cacheName})) {  
         $cache->{$cacheName} = $default;  
     }  
   
     return;  =item Package Variables
 }  
   
 sub ProcessFormData{  =item @FullClasslist The full classlist
     my ($cache)=@_;  
   
     $cache->{'reportKey'} = 'false';  =item @Students The students we are concerned with for this invocation
   
     &Apache::loncommon::get_unprocessed_cgi($ENV{'QUERY_STRING'},  =item @Sections The sections available in this class
                                             ['sort','download','reportSelected',  
                                              'StudentAssessmentStudent']);  
     &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, 'DownloadAll', 'DownloadAll', 'false');  
     &CheckFormElement($cache, 'sort', 'sort', 'fullname');  
     &CheckFormElement($cache, 'download', 'download', 'false');  
   
     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'});  
   
     foreach (keys(%ENV)) {  
         if(/form\.Analyze:::/) {  
 #            $cache->{'reportSelected'} = 'Analyze';  
 #            $cache->{'reportKey'} = 'Problem Analysis';  
             my ($uri, $title, $part, $problem);  
             (undef, $uri, $title, $part, $problem)=split(':::', $_);  
             $cache->{'AnalyzeURI'}     = $uri;  
             $cache->{'AnalyzeTitle'}   = $title;  
             $cache->{'AnalyzePart'}    = $part;  
             $cache->{'AnalyzeProblem'} = $problem;  
               
             &CheckFormElement($cache, 'Interval', 'Interval', '1');  
         }  
     }  
   
     return;  =item $curr_student The student currently being examined
   
     # Select page to display  =item $prev_student The student previous in the classlist
     if(defined($ENV{'form.ProblemStatistics'}) ||  
        defined($ENV{'form.ProblemStatisticsRecalculate'}) ||   
        defined($ENV{'form.DisplayCSVFormat'})) {  
         $cache->{'GoToPage'} = 'ProblemStatistics';  
         &CheckFormElement($cache, 'DisplayCSVFormat',  
                           'DisplayFormat', 'Display Table Format');  
         &CheckFormElement($cache, 'Ascend','ProblemStatisticsAscend',  
                           'Ascending');  
         &CheckFormElement($cache, 'Maps', 'ProblemStatisticsMap',   
                           'All Maps');  
     } elsif(defined($ENV{'form.ProblemAnalysis'})) {  
         $cache->{'GoToPage'} = 'ProblemAnalysis';  
         &CheckFormElement($cache, 'Interval', 'Interval', '1');  
     } elsif(defined($ENV{'form.DoDiffGraph'})) {  
         $cache->{'GoToPage'} = 'DoDiffGraph';  
     } elsif(defined($ENV{'form.PercentWrongGraph'})) {  
         $cache->{'GoToPage'} = 'PercentWrongGraph';  
     } elsif(defined($ENV{'form.ActivityLog'})) {  
         $cache->{'GoToPage'} = 'ActivityLog';  
     } else {  
         $cache->{'GoToPage'} = 'Menu';  
     }  
   
     &CheckFormElement($cache, 'Status', 'Status', 'Active');  =item $next_student The student next in the classlist
   
     return;  =over
 }  
   =cut 
   
   #######################################################
   #######################################################
   #
   # Classlist variables
   #
   my $curr_student;
   my $prev_student;
   my $next_student;
   
   #######################################################
   #######################################################
   
 =pod  =pod
   
 =item &SortStudents()  =item &clear_classlist_variables()
   
 Determines which students to display and in which order.  Which are   undef the following package variables:
 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  =over
   
   =item @FullClasslist
   
   =item @Students
   
   =item @Sections
   
   =item @SelectedSections
   
 Input: $students, $CacheData  =item %StudentData
   
 $students: A array pointer to a list of students (username:domain)  =item @StudentDataOrder
   
 $CacheData: A pointer to the hash tied to the cached data  =item @SelectedStudentData
   
 Output: \@order  =item $curr_student
   
 @order: An ordered list of students (username:domain)  =item $prev_student
   
   =item $next_student
   
 =back  =back
   
 =cut  =cut
   
 sub SortStudents {  #######################################################
     my ($cache)=@_;  #######################################################
   sub clear_classlist_variables {
       undef(@FullClasslist);
       undef(@Students);
       undef(@Sections);
       undef(@SelectedSections);
       undef(%StudentData);
       undef(@SelectedStudentData);
       undef($curr_student);
       undef($prev_student);
       undef($next_student);
   }
   
   #######################################################
   #######################################################
   
   =pod
   
   =item &PrepareClasslist()
   
   Build up the classlist information.  The classlist information is kept in
   the following package variables:
   
   =over
   
   =item @FullClasslist
   
   =item @Students
   
   =item @Sections
   
   =item @SelectedSections
   
   =item %StudentData
   
   =item @SelectedStudentData
   
   =item $curr_student
   
   =item $prev_student
   
   =item $next_student
   
     my @students = split(':::',$cache->{'NamesOfStudents'});  =back
     my @sorted1Students=();  
     foreach (@students) {  $curr_student, $prev_student, and $next_student may not be defined, depending
         if($cache->{'Status'} eq 'Any' ||   upon the calling context.
            $cache->{$_.':Status'} eq $cache->{'Status'}) {  
             push(@sorted1Students, $_);  =cut
   
   #######################################################
   #######################################################
   sub PrepareClasslist {
       my %Sections;
       &clear_classlist_variables();
       #
       # Retrieve the classlist
       my $cid  = $ENV{'request.course.id'};
       my $cdom = $ENV{'course.'.$cid.'.domain'};
       my $cnum = $ENV{'course.'.$cid.'.num'};
       my ($classlist,$field_names) = &Apache::loncoursedata::get_classlist($cid,
                                                                     $cdom,$cnum);
       if (exists($ENV{'form.Section'})) {
           if (ref($ENV{'form.Section'})) {
               @SelectedSections = @{$ENV{'form.Section'}};
           } elsif ($ENV{'form.Section'} !~ /^\s*$/) {
               @SelectedSections = ($ENV{'form.Section'});
         }          }
     }      }
       @SelectedSections = ('all') if (! @SelectedSections);
       foreach (@SelectedSections) {
           if ($_ eq 'all') {
               @SelectedSections = ('all');
           }
       }
       #
       # Deal with instructors with restricted section access
       if ($ENV{'request.course.sec'} !~ /^\s*$/) {
           @SelectedSections = ($ENV{'request.course.sec'});
       }
       #
       # Set up %StudentData
       @StudentDataOrder = qw/fullname username domain id section status/;
       foreach my $field (@StudentDataOrder) {
           $StudentData{$field}->{'title'} = $field;
           $StudentData{$field}->{'base_width'} = length($field);
           $StudentData{$field}->{'width'} = 
                                  $StudentData{$field}->{'base_width'};
       }
       #
       # get the status requested
       my $requested_status = 'Active';
       $requested_status = $ENV{'form.Status'} if (exists($ENV{'form.Status'}));
       #
       # Process the classlist
       while (my ($student,$student_data) = each (%$classlist)) {
           my $studenthash = ();
           for (my $i=0; $i< scalar(@$field_names);$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; 
               }
           }
           push (@FullClasslist,$studenthash);
           #
           # Build up a list of sections
           my $section = $studenthash->{'section'};
           if (! defined($section) || $section =~/^\s*$/ || $section == -1) {
               $studenthash->{'section'} = 'none';
               $section = $studenthash->{'section'};
           }
           $Sections{$section}++;
           #
           # Only put in the list those students we are interested in
           foreach my $sect (@SelectedSections) {
               if ( (($sect eq 'all') || 
                     ($section eq $sect)) &&
                    (($studenthash->{'status'} eq $requested_status) || 
                     ($requested_status eq 'Any')) 
                    ){
                   push (@Students,$studenthash);
                   last;
               }
           }
       }
       #
       # Put the consolidated section data in the right place
       if ($ENV{'request.course.sec'} !~ /^\s*$/) {
           @Sections = ($ENV{'request.course.sec'});
       } else {
           @Sections = sort {$a cmp $b} keys(%Sections);
           unshift(@Sections,'all'); # Put 'all' at the front of the list
       }
       #
       # Sort the Students
       my $sortby = 'fullname';
       $sortby = $ENV{'form.sort'} if (exists($ENV{'form.sort'}));
       my @TmpStudents = sort { $a->{$sortby} cmp $b->{$sortby} ||
                                $a->{'fullname'} cmp $b->{'fullname'} } @Students;
       @Students = @TmpStudents;
       # 
       # Now deal with that current student thing....
       $curr_student = undef;
       if (exists($ENV{'form.SelectedStudent'})) {
           my ($current_uname,$current_dom) = 
               split(':',$ENV{'form.SelectedStudent'});
           my $i;
           for ($i = 0; $i<=$#Students; $i++) {
               next if (($Students[$i]->{'username'} ne $current_uname) || 
                        ($Students[$i]->{'domain'}   ne $current_dom));
               $curr_student = $Students[$i];
               last; # If we get here, we have our student.
           }
           if (defined($curr_student)) {
               if ($i == 0) {
                   $prev_student = undef;
               } else {
                   $prev_student = $Students[$i-1];
               }
               if ($i == $#Students) {
                   $next_student = undef;
               } else {
                   $next_student = $Students[$i+1];
               }
           }
       }
       #
       if (exists($ENV{'form.StudentData'})) {
           if (ref($ENV{'form.StudentData'}) eq 'ARRAY') {
               @SelectedStudentData = @{$ENV{'form.StudentData'}};
           } else {
               @SelectedStudentData = ($ENV{'form.StudentData'});
           }
       } else {
           @SelectedStudentData = ('username');
       }
       foreach (@SelectedStudentData) {
           if ($_ eq 'all') {
               @SelectedStudentData = ('all');
               last;
           }
       }
       #
       return;
   }
   
   
   #######################################################
   #######################################################
   
   =pod
   
     my $sortBy = '';  =item get_students
     if(defined($cache->{'sort'})) {  
         $sortBy = ':'.$cache->{'sort'};  Returns a list of the selected students
   
   =cut
   
   #######################################################
   #######################################################
   sub get_students {
       if (! @Students) {
           &PrepareClasslist()
     }      }
     my @order = sort { $cache->{$a.$sortBy} cmp $cache->{$b.$sortBy} ||      return @Students;
                        $cache->{$a.':fullname'} cmp $cache->{$b.':fullname'} }   }
                 @sorted1Students;  
   #######################################################
   #######################################################
   
   =pod
   
   =item &current_student()
   
     return \@order;  Returns a pointer to a hash containing data about the currently
   selected student.
   
   =cut
   
   #######################################################
   #######################################################
   sub current_student { 
       return $curr_student;
 }  }
   
   #######################################################
   #######################################################
   
 =pod  =pod
   
 =item &SpaceColumns()  =item &previous_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 student prior
 the max of the data for that column and its header.  in the list of students.  Or something.  
   
 =over 4  =cut
   
   #######################################################
   #######################################################
   sub previous_student { 
       return $prev_student;
   }
   
 Input: $students, $studentInformation, $headings, $ChartDB  #######################################################
   #######################################################
   
 $students: An array pointer to a list of students (username:domain)  =pod
   
 $studentInformatin: The type of data for the student information.  It is  =item &next_student()
 used as part of the key in $CacheData.  
   
 $headings: The name of the student information columns.  Returns a pointer to a hash containing data about the next student
   to be viewed.
   
 $ChartDB: The name of the cache database which is opened for read/write.  =cut
   
 Output: None - All data stored in cache.  #######################################################
   #######################################################
   sub next_student { 
       return $next_student;
   }
   
 =back  #######################################################
   #######################################################
   
   =pod
   
   =item &clear_sequence_variables()
   
 =cut  =cut
   
 sub SpaceColumns {  #######################################################
     my ($students,$studentInformation,$headings,$cache)=@_;  #######################################################
   sub clear_sequence_variables {
       undef($top_map);
       undef(@Sequences);
       undef(@Assessments);
   }
   
     # Initialize Lengths  #######################################################
     for(my $index=0; $index<(scalar @$headings); $index++) {  #######################################################
         my @titleLength=split(//,$headings->[$index]);  
         $cache->{$studentInformation->[$index].':columnWidth'}=  =pod
             scalar @titleLength;  
     }  =item &SetSelectedMaps($elementname)
   
     foreach my $name (@$students) {  Sets the @SelectedMaps array from $ENV{'form.'.$elementname};
         foreach (@$studentInformation) {  
             my @dataLength=split(//,$cache->{$name.':'.$_});  =cut
             my $length=(scalar @dataLength);  
             if($length > $cache->{$_.':columnWidth'}) {  #######################################################
                 $cache->{$_.':columnWidth'}=$length;  #######################################################
             }  sub SetSelectedMaps {
       my $elementname = shift;
       if (exists($ENV{'form.'.$elementname})) {
           if (ref($ENV{'form.'.$elementname})) {
               @SelectedMaps = @{$ENV{'form.'.$elementname}};
           } else {
               @SelectedMaps = ($ENV{'form.'.$elementname});
         }          }
       } else {
           @SelectedMaps = ('all');
     }      }
   
     return;  
 }  }
   
 sub PrepareData {  
     my ($c, $cacheDB, $studentInformation, $headings)=@_;  
   
     # Test for access to the cache data  #######################################################
     my $courseID=$ENV{'request.course.id'};  #######################################################
     my $isRecalculate=0;  
     if(defined($ENV{'form.Recalculate'})) {  
         $isRecalculate=1;  
     }  
   
     my $isCached = &Apache::loncoursedata::TestCacheData($cacheDB,   =pod
                                                          $isRecalculate);  
     if($isCached < 0) {  
         return "Unable to tie hash to db file.";  
     }  
   
     # Download class list information if not using cached data  =item &Sequences_with_Assess()
     my %cache;  
     unless(tie(%cache,'GDBM_File',$cacheDB,&GDBM_WRCREAT,0640)) {  
         return "Unable to tie hash to db file.";  
     }  
   
     if(!$isCached) {  Returns an array containing the subset of @Sequences which contain
         my $processTopResourceMapReturn=  assessments.
             &Apache::loncoursedata::ProcessTopResourceMap(\%cache, $c);  
         if($processTopResourceMapReturn ne 'OK') {  =cut
             untie(%cache);  
             return $processTopResourceMapReturn;  #######################################################
   #######################################################
   sub Sequences_with_Assess {
       my @Sequences_to_Show;
       foreach my $map_symb (@SelectedMaps) {
           foreach my $sequence (@Sequences) {
               next if ($sequence->{'symb'} ne $map_symb && $map_symb ne 'all');
               next if ($sequence->{'num_assess'} < 1);
               push (@Sequences_to_Show,$sequence);
         }          }
     }      }
       return @Sequences_to_Show;
   }
   
     if($c->aborted()) {  #######################################################
         untie(%cache);  #######################################################
         return 'aborted';   
     }  =pod
   
   =item &PrepareCourseData($r)
   
   =cut
   
     my $classlist=&Apache::loncoursedata::DownloadClasslist($courseID,  #######################################################
                                                 $cache{'ClasslistTimestamp'},  #######################################################
                                                 $c);  sub PrepareCourseData {
     foreach (keys(%$classlist)) {      my ($r) = @_;
         if(/^(con_lost|error|no_such_host)/i) {      &clear_sequence_variables();
             untie(%cache);      my ($top,$sequences,$assessments) = 
             return "Error getting student data.";          &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));
       @Sequences = @{$sequences} if (ref($sequences) eq 'ARRAY');
       @Assessments = @{$assessments} if (ref($assessments) eq 'ARRAY');
       #
       # Compute column widths
       foreach my $seq (@Sequences) {
           my $name_length = length($seq->{'title'});
           my $num_parts = $seq->{'num_assess_parts'};
           #
           # Use 3 digits for each the sum and total, which means 7 total...
           my $num_col = $num_parts+7;
           if ($num_col < $name_length) {
               $num_col = $name_length;
         }          }
           $seq->{'base_width'} = $name_length;
           $seq->{'width'} = $num_col;
     }      }
       return;
   }
   
     if($c->aborted()) {  #######################################################
         untie(%cache);  #######################################################
         return 'aborted';   
     }  
   
     # Active is a temporary solution, remember to change  =pod
     Apache::loncoursedata::ProcessClasslist(\%cache,$classlist,$courseID,$c);  
     if($c->aborted()) {  
         untie(%cache);  
         return 'aborted';   
     }  
   
     &ProcessFormData(\%cache);  =item &log_sequence($sequence,$recursive,$padding)
     my $students = &SortStudents(\%cache);  
     &SpaceColumns($students, $studentInformation, $headings, \%cache);  
     $cache{'updateTime:columnWidth'}=24;  
   
     if($cache{'download'} ne 'false') {  Write data about the sequence to a logfile.  If $recursive is not
         my $who = $cache{'download'};  undef the data is written recursively.  $padding is used for recursive
         my $courseData =   calls.
             &Apache::loncoursedata::DownloadCourseInformation(  
                                              $who, $courseID,   =cut
                                              $cache{$who.':lastDownloadTime'});  
         &Apache::loncoursedata::ProcessStudentData(\%cache, $courseData, $who);  #######################################################
         $cache{'download'} = 'false';  #######################################################
     } elsif($cache{'DownloadAll'} ne 'false') {  sub log_sequence {
         my @allStudents;      my ($seq,$recursive,$padding) = @_;
         if($cache{'DownloadAll'} eq 'sorted') {      $padding = '' if (! defined($padding));
             @allStudents = @$students;      if (ref($seq) ne 'HASH') {
           &Apache::lonnet::logthis('log_sequence passed bad sequnce');
           return;
       }
       &Apache::lonnet::logthis($padding.'sequence '.$seq->{'title'});
       while (my($key,$value) = each(%$seq)) {
           next if ($key eq 'contents');
           if (ref($value) eq 'ARRAY') {
               for (my $i=0;$i< scalar(@$value);$i++) {
                   &Apache::lonnet::logthis($padding.$key.'['.$i.']='.
                                            $value->[$i]);
               }
         } else {          } else {
             @allStudents = split(':::', $cache{'NamesOfStudents'});              &Apache::lonnet::logthis($padding.$key.'='.$value);
         }          }
         foreach (@allStudents) {      }
             my $courseData =       if (defined($recursive)) {
                 &Apache::loncoursedata::DownloadCourseInformation(          &Apache::lonnet::logthis($padding.'-'x20);
                                              $_, $courseID,           &Apache::lonnet::logthis($padding.'contains:');
                                              $cache{$_.':lastDownloadTime'});          foreach my $item (@{$seq->{'contents'}}) {
             &Apache::loncoursedata::ProcessStudentData(\%cache, $courseData,               if ($item->{'type'} eq 'container') {
                                                        $_);                  &log_sequence($item,$recursive,$padding.'    ');
             if($c->aborted()) {              } else {
                 untie(%cache);                  &Apache::lonnet::logthis($padding.'title = '.$item->{'title'});
                 return 'aborted';                   while (my($key,$value) = each(%$item)) {
                       next if ($key eq 'title');
                       if (ref($value) eq 'ARRAY') {
                           for (my $i=0;$i< scalar(@$value);$i++) {
                               &Apache::lonnet::logthis($padding.$key.'['.$i.']='.
                                                        $value->[$i]);
                           }
                       } else {
                           &Apache::lonnet::logthis($padding.$key.'='.$value);
                       }
                   }
             }              }
         }          }
         $cache{'DownloadAll'} = 'false';          &Apache::lonnet::logthis($padding.'end contents of '.$seq->{'title'});
           &Apache::lonnet::logthis($padding.'-'x20);
     }      }
       return;
   }
   
     if($c->aborted()) {  ##############################################
         untie(%cache);  ##############################################
         return 'aborted';   
     }  
   
     untie(%cache);  =pod 
   
     return ('OK', $students);  =item &StudentDataSelect($elementname,$status,$numvisible,$selected)
 }  
   
   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)
   
 # Create progress  =over 4
 sub Create_PrgWin {  
     my ($r)=@_;  
     $r->print(<<ENDPOP);  
     <script>  
     popwin=open('','popwin','width=400,height=100');  
     popwin.document.writeln('<html><body bgcolor="#88DDFF">'+  
       '<title>LON-CAPA Statistics</title>'+  
       '<h4>Computation Progress</h4>'+  
       '<form name=popremain>'+  
       '<input type=text size=35 name=remaining value=Starting></form>'+  
       '</body></html>');  
     popwin.document.close();  
     </script>  
 ENDPOP  
   
     $r->rflush();  =item $elementname The name of the HTML form element
 }  
   
 # update progress  =item $status 'multiple' or 'single' selection box
 sub Update_PrgWin {  
     my ($totalStudents,$index,$name,$r)=@_;  
     $r->print('<script>popwin.document.popremain.remaining.value="'.  
               'Computing '.$index.'/'.$totalStudents.': '.  
               $name.'";</script>');  
     $r->rflush();  
 }  
   
 # close Progress Line  =item $numvisible The number of options to be visible
 sub Close_PrgWin {  
     my ($r)=@_;  
     $r->print('<script>popwin.close()</script>');  
     $r->rflush();   
 }  
   
 # For loading the colored table for display or un-colored for print  =back
 sub setbgcolor {  
     my $PrintTable=shift;  =cut
     my %color;  
     if ($PrintTable){  ##############################################
  $color{"gb"}="#FFFFFF";  ##############################################
  $color{"red"}="#FFFFFF";  sub StudentDataSelect {
  $color{"yellow"}="#FFFFFF";      my ($elementname,$status,$numvisible)=@_;
  $color{"green"}="#FFFFFF";      if ($numvisible < 1) {
  $color{"purple"}="#FFFFFF";          return;
     } else {      }
  $color{"gb"}="#DDFFFF";      #
  $color{"red"}="#FFDDDD";      # Build the form element
  $color{"yellow"}="#EEFFCC";      my $Str = "\n";
  $color{"green"}="#DDFFDD";      $Str .= '<select name="'.$elementname.'" ';
  $color{"purple"}="#FFDDFF";      if ($status ne 'single') {
           $Str .= 'multiple="true" ';
       }
       $Str .= 'size="'.$numvisible.'" >'."\n";
       #
       # 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 $Str;
   }
   
   ##############################################
   ##############################################
   
     return \%color;  =pod 
   
   =item &MapSelect($elementname,$status,$numvisible,$restriction) 
   
   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.
   
   =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
   
   =item $restriction Code reference to subroutine which returns true or 
   false.  The code must expect a reference to a sequence data structure.
   
   =back
   
   =cut
   
   ##############################################
   ##############################################
   sub MapSelect {
       my ($elementname,$status,$numvisible,$restriction)=@_;
       if ($numvisible < 1) {
           return;
       }
       #
       # Set up array of selected items
       &SetSelectedMaps($elementname);
       #
       # 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";
       #
       # Deal with 'all'
       foreach (@SelectedMaps) {
           if ($_ eq 'all') {
               @SelectedMaps = ('all');
               last;
           }
       }
       #
       # Put in option for 'all'
       $Str .= '    <option value="all" ';
       foreach (@SelectedMaps) {
           if ($_ eq 'all') {
               $Str .= 'selected ';
               last;
           }
       }
       $Str .= ">all</option>\n";
       #
       # Loop through the sequences
       foreach my $seq (@Sequences) {
           next if (! $restriction->($seq));
           $Str .= '    <option value="'.$seq->{'symb'}.'" ';
           foreach (@SelectedMaps) {
               if ($seq->{'symb'} eq $_) {
                   $Str .= 'selected ';
                   last;
               }
           }
           $Str .= '>'.$seq->{'title'}."</option>\n";
       }
       $Str .= "</select>\n";
       return $Str;
 }  }
   
 sub BuildClasslist {  ##############################################
     my ($cacheDB,$students,$studentInformation,$headings)=@_;  ##############################################
   
   =pod 
   
   =item &SectionSelect($elementname,$status,$numvisible) 
   
   Returns html for a selection box allowing the user to choose one (or more) 
   of the sections in the course.  
   
   Uses the package variables @Sections and @SelectedSections
   =over 4
   
     my %cache;  =item $elementname The name of the HTML form element
     unless(tie(%cache,'GDBM_File',$cacheDB,&GDBM_READER,0640)) {  
         return '<html><body>Unable to tie database.</body></html>';  =item $status 'multiple' or 'single' selection box
   
   =item $numvisible The number of options to be visible
   
   =back
   
   =cut
   
   ##############################################
   ##############################################
   sub SectionSelect {
       my ($elementname,$status,$numvisible)=@_;
       if ($numvisible < 1) {
           return;
       }
       #
       # Make sure we have the data we need to continue
       if (! @Sections) {
           &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 (@SelectedSections) {
               if ($s eq $_) {
                   $Str .= 'selected ';
                   last;
               }
           }
           $Str .= '>'.$s."</option>\n";
     }      }
       $Str .= "</select>\n";
       return $Str;
   }
   
   ##################################################
   ##################################################
   sub DisplayClasslist {
       my ($r)=@_;
       #
       my @Fields = ('fullname','username','domain','id','section');
       #
     my $Str='';      my $Str='';
       if (! @Students) {
           if ($SelectedSections[0] eq 'all') { 
               if (lc($ENV{'form.Status'}) eq 'any') {
                   $Str .= '<h2>There are no students in the course.</h2>';
               } elsif (lc($ENV{'form.Status'}) eq 'active') {
                   $Str .= '<h2>There are no currently enrolled students in '.
                       'the course.</h2>';
               } elsif (lc($ENV{'form.Status'}) eq 'expired') {
                   $Str .= '<h2>There are no previously enrolled '.
                       'students in the course.</h2>';
               }
           } else { 
               my $sections;
               if (@SelectedSections == 1) {
                   $sections = 'section '.$SelectedSections[0];
               } elsif (@SelectedSections > 2) {
                   $sections = 'sections '.join(', ',@SelectedSections);
                   $sections =~ s/, ([^,])*$/, and $1/;
               } else {
                   $sections = 'sections '.join(' and ',@SelectedSections);
               }
               if (lc($ENV{'form.Status'}) eq 'any') {
                   $Str .= '<h2>There are no students in '.$sections.'.</h2>';
               } elsif (lc($ENV{'form.Status'}) eq 'active') {
                   $Str .= '<h2>There are no currently enrolled students '.
                       'in '.$sections.'.</h2>';
               } elsif (lc($ENV{'form.Status'}) eq 'expired') {
                   $Str .= '<h2>There are no previously enrolled students '.
                       'in '.$sections.'.</h2>';
               }
           }
           $Str.= '<a href="/adm/statistics?reportSelected=student_assessment">'.
               'Return to the chart.</a>';
           $r->print($Str);
           $r->rflush();
           return;
       }
   
       # "Click" is asinine but it is probably not my place to change the world.
       $Str .= '<h2>Click on a students name or username to view their chart</h2>';
     $Str .= '<table border="0"><tr><td bgcolor="#777777">'."\n";      $Str .= '<table border="0"><tr><td bgcolor="#777777">'."\n";
     $Str .= '<table border="0" cellpadding="3"><tr bgcolor="#e6ffff">'."\n";      $Str .= '<table border="0" cellpadding="3"><tr bgcolor="#e6ffff">'."\n";
       foreach my $field (@Fields) {
     my $displayString = '<td align="left"><a href="/adm/statistics?';          $Str .= '<th><a href="/adm/statistics?reportSelected=classlist&sort='.$field.'">'.$field.
     $displayString .= 'sort=LINKDATA">DISPLAYDATA&nbsp</a></td>'."\n";              '</a></th>';
     $Str .= &Apache::lonhtmlcommon::CreateHeadings(\%cache, $studentInformation,      }
                                                    $headings, $displayString);  
     $Str .= '</tr>'."\n";      $Str .= '</tr>'."\n";
     my $alternate=0;      #
     foreach (@$students) {      my $alternate = 0;
         my ($username, $domain) = split(':', $_);      foreach my $student (@Students) { # @Students is a package variable
           my $sname = $student->{'username'}.':'.$student->{'domain'};
         if($alternate) {          if($alternate) {
             $Str .= '<tr bgcolor="#ffffe6">';              $Str .= '<tr bgcolor="#ffffe6">';
         } else {          } else {
             $Str .= '<tr bgcolor="#ffffc6">';              $Str .= '<tr bgcolor="#ffffc6">';
         }          }
         $alternate = ($alternate + 1) % 2;          $alternate = ($alternate + 1) % 2;
         foreach my $data (@$studentInformation) {          #
           foreach my $field (@Fields) {
             $Str .= '<td>';              $Str .= '<td>';
             if($data 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 .= &Apache::lonnet::escape('student_assessment');
                 $Str .= '&StudentAssessmentStudent=';                  $Str .= '&sort='.&Apache::lonnet::escape($ENV{'form.sort'});
                 $Str .= &Apache::lonnet::escape($cache{$_.':'.$data}).'">';                  $Str .= '&SelectedStudent=';
                 $Str .= $cache{$_.':'.$data}.'&nbsp';                  $Str .= &Apache::lonnet::escape($sname).'">';
                   $Str .= $student->{$field}.'&nbsp';
                 $Str .= '</a>';                  $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 {              } else {
                 $Str .= $cache{$_.':'.$data}.'&nbsp';                  $Str .= $student->{$field};
             }              }
               $Str .= '</td>';
             $Str .= '</td>'."\n";  
         }          }
           $Str .= "</tr>\n";
     }      }
   
     $Str .= '</tr>'."\n";  
     $Str .= '</table></td></tr></table>'."\n";      $Str .= '</table></td></tr></table>'."\n";
       #
     untie(%cache);      $r->print($Str);
       $r->rflush();
     return $Str;      #
       return;
 }  }
   
 sub BuildStatistics {  ##############################################
     my ($r)=@_;  ##############################################
   sub CreateMainMenu {
     my $c = $r->connection;      my ($status,$reports,$current)=@_;
     my @studentInformation=('fullname','section','id','domain','username',      #
                             'updateTime');      my $Str = '';
     my @headings=('Full Name', 'Section', 'PID', 'Domain', 'User Name',      #
                   'Last Updated');      $Str  = '<input type="hidden" name="reportSelected" value="'.$current.'">';
     my $spacing = '   ';  #    $Str .= '<table border="0"><tbody><tr>'."\n";
     my %reports = ('classlist'          => 'Class list',  #    $Str .= '<td align="center"><b>Report:</b></td>'."\n";
                    'problem_statistics' => 'Problem Statistics',  #    $Str .= '<td align="center">';
                    'student_assessment' => 'Student Assessment',  #    $Str .= '<select name="reportSelected" '.
                    'reportSelected'     => 'Class list');  #        'onchange="document.Statistics.submit()">'."\n";
   #    foreach (sort(keys(%$reports))) {
     my %cache;  #        $Str .= '<option value="'.$_.'"';
     my $courseID=$ENV{'request.course.id'};  #        if($current eq $_) {
     my $cacheDB = "/home/httpd/perl/tmp/$ENV{'user.name'}".  #            $Str .= ' selected';
                   "_$ENV{'user.domain'}_$courseID\_statistics.db";  
   
     my %color=&setbgcolor(0);  
     my ($returnValue, $students) = &PrepareData($c, $cacheDB,   
                                                 \@studentInformation,   
                                                 \@headings);  
     if($returnValue ne 'OK') {  
         $r->print('<html><body>'.$returnValue."\n".'</body></html>');  
         return OK;  
     }  
   
     my $GoToPage;  
     if(tie(%cache,'GDBM_File',$cacheDB,&GDBM_READER,0640)) {  
         $GoToPage = $cache{'reportSelected'};  
         $reports{'reportSelected'} = $cache{'reportSelected'};  
 #        if(defined($cache{'reportKey'}) && $cache{'reportKey'} ne 'false') {  
 #            $reports{$cache{'reportKey'}} = $cache{'reportSelected'};  
 #        }  #        }
   #        $Str .= '>'.$reports->{$_}.'</option>'."\n";
         if(defined($cache{'OptionResponses'})) {  #    }
             $reports{'problem_analysis'} = 'Problem Analysis';  #    $Str .= '</select></td>'."\n";
         }  #    #
   #    $Str .= '<td>'.('&nbsp;'x30).'</td>';
         $r->print(&Apache::lonhtmlcommon::Title('LON-CAPA Statistics'));  #    $Str .= '<td align="center">'.
         $r->print('<form name="Statistics" ');  #        '<input type="submit" name="ClearCache" value="Clear Caches" />'.
         $r->print('method="post" action="/adm/statistics">');  #            "</td>\n";
         $r->print(&Apache::lonhtmlcommon::CreateStatisticsMainMenu(  #    $Str .= '</tr></tbody></table>'."\n";
                                                              $cache{'Status'},   #    $Str .= '<hr>'."\n";
                                                              \%reports));      #
         untie(%cache);      return $Str;
     } 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') {  
         $r->print(  
         &Apache::lonproblemstatistics::BuildProblemStatisticsPage($cacheDB,   
                                                                   $students,   
                                                                   $courseID,   
                                                                   $c,$r,  
   \%color));  
     } elsif($GoToPage eq 'Problem Analysis') {  
         $r->print(  
               &Apache::lonproblemanalysis::BuildProblemAnalysisPage($cacheDB));  
     } elsif($GoToPage eq 'Student Assessment') {  
         $r->print(  
             &Apache::lonstudentassessment::BuildStudentAssessmentPage($cacheDB,  
                                                             $students,  
                                                             $courseID,  
                                                             'Statistics',  
                                                             \@headings,  
                                                             $spacing,  
                                                             \@studentInformation,  
                                                             $r, $c));  
     } elsif($GoToPage eq 'Analyze') {  
         $r->print(&Apache::lonproblemanalysis::BuildAnalyzePage($cacheDB,   
                                                                 $students,   
                                                                 $courseID));  
     } elsif($GoToPage eq 'DoDiffGraph') {  
         &Apache::lonproblemstatistics::BuildDiffGraph($r);  
     } elsif($GoToPage eq 'PercentWrongGraph') {  
         &Apache::lonproblemstatistics::BuildWrongGraph($r);  
     } elsif($GoToPage eq 'Class list') {  
         $r->print(&BuildClasslist($cacheDB, $students, \@studentInformation,  
                                   \@headings));  
     }  
   
     $r->print('</form>'."\n");  
     $r->print("\n".'</body>'."\n".'</html>');  
     $r->rflush();  
   
     return OK;  
 }  }
   
 # ================================================================ Main Handler  ##############################################
   ##############################################
 sub handler {  sub handler {
     my $r=shift;      my $r=shift;
       my $c = $r->connection();
     unless(&Apache::lonnet::allowed('vgr',$ENV{'request.course.id'})) {      #
       &Apache::loncoursedata::clear_internal_caches();
       #
       &Apache::loncoursedata::clear_internal_caches();
       #
       # Check for overloading
       my $loaderror=&Apache::lonnet::overloaderror($r);
       if ($loaderror) { return $loaderror; }
       $loaderror=
          &Apache::lonnet::overloaderror($r,
            $ENV{'course.'.$ENV{'request.course.id'}.'.home'});
       if ($loaderror) { return $loaderror; }
       #
       # Check for access
       if (! &Apache::lonnet::allowed('vgr',$ENV{'request.course.id'})) {
         $ENV{'user.error.msg'}=          $ENV{'user.error.msg'}=
         $r->uri.":vgr:0:0:Cannot view grades for complete course";              $r->uri.":vgr:0:0:Cannot view grades for complete course";
         return HTTP_NOT_ACCEPTABLE;           if (! &Apache::lonnet::allowed('vgr',
                         $ENV{'request.course.id'}.'/'.$ENV{'request.course.sec'})) {
               $ENV{'user.error.msg'}=
                   $r->uri.":vgr:0:0:Cannot view grades with given role";
               return HTTP_NOT_ACCEPTABLE;
           }
     }      }
       #
     # Set document type for header only      # Set document type for header only
     if($r->header_only) {      if($r->header_only) {
         if ($ENV{'browser.mathml'}) {          if ($ENV{'browser.mathml'}) {
Line 575  sub handler { Line 961  sub handler {
         $r->send_http_header;          $r->send_http_header;
         return OK;          return OK;
     }      }
       #
     unless($ENV{'request.course.fn'}) {      # Send the header
  my $requrl=$r->uri;  
         $ENV{'user.error.msg'}="$requrl:bre:0:0:Course not initialized";  
         return HTTP_NOT_ACCEPTABLE;   
     }  
   
     $r->content_type('text/html');      $r->content_type('text/html');
     $r->send_http_header;      $r->send_http_header;
       #
     &BuildStatistics($r);      # Extract form elements from query string
       &Apache::loncommon::get_unprocessed_cgi($ENV{'QUERY_STRING'},
                                               ['sort','reportSelected',
                                                'SelectedStudent']);
       if (! exists($ENV{'form.reportSelected'})) {
           $ENV{'form.reportSelected'} = 'student_assessment';
       }
       #
       # Give the LON-CAPA page header
       $r->print(&Apache::lonhtmlcommon::Title('Course Statistics and Charts'));
       $r->rflush();
       #
       if (! &Apache::lonmysql::verify_sql_connection()) {
           my $serveradmin = $r->dir_config('lonAdmEMail');
           $r->print(<<END);
   <h2><font color="Red">Unable to connect to database!</font></h2>
   <p>
   Please notify the server administrator <b>$serveradmin</b>.
   </p><p>
   Course Statistics and Charts cannot be retrieved until the database is
   restarted.  Your data is intact but cannot be displayed at this time.
   </p>
   </body>
   </html>
   END
           return;
       }
       #
       # Clean out the caches
       if (exists($ENV{'form.ClearCache'})) {
           &Apache::loncoursedata::delete_caches($ENV{'requres.course.id'});
       }
       #
       # Set up the statistics and chart environment
       &PrepareClasslist();
       &PrepareCourseData($r);
       #
       # Begin form output
       $r->print('<form name="Statistics" ');
       $r->print('method="post" action="/adm/statistics">');
       #
       # Print main menu
       my %reports = ('classlist'          => 'Class list',
                      'problem_statistics' => 'Problem Statistics',
                      'student_assessment' => 'Problem Status Chart',
   #                   'percentage'         => 'Correct-problems Plot',
   #                   'option_response'    => 'Option Response Analysis',
   #                   'activitylog'        => 'Activity Log',
                      );
       $r->print(&CreateMainMenu($ENV{'form.status'},
                                 \%reports,$ENV{'form.reportSelected'}));
       $r->rflush();
       #
       my $GoToPage = $ENV{'form.reportSelected'};
       if($GoToPage eq 'activitylog') {
   #        &Apache::lonproblemstatistics::Activity();
       } elsif($GoToPage eq 'problem_statistics') {
           &Apache::lonproblemstatistics::BuildProblemStatisticsPage($r,$c);
       } elsif($GoToPage eq 'option_response') {
   #        &Apache::lonproblemanalysis::BuildProblemAnalysisPage($r,$c);
       } elsif($GoToPage eq 'student_assessment') {
           &Apache::lonstudentassessment::BuildStudentAssessmentPage($r,$c);
       } elsif($GoToPage eq 'DoDiffGraph' || $GoToPage eq 'PercentWrongGraph') {
   #        &Apache::lonproblemstatistics::BuildGraphicChart($r,$c);
       } elsif($GoToPage eq 'Correct-problems Plot') {
   # &Apache::lonpercentage::BuildPercentageGraph($r,$c);
       }
       #
       $r->print("</form>\n");
       $r->print("</body>\n</html>\n");
       $r->rflush();
       #
     return OK;      return OK;
 }  }
   
 1;  1;
   
   #######################################################
   #######################################################
   
   =pod
   
   =back
   
   =cut
   
   #######################################################
   #######################################################
   
 __END__  __END__
   

Removed from v.1.32  
changed lines
  Added in v.1.78.2.2


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