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

Diff for /loncom/interface/lonstatistics.pm between versions 1.47 and 1.76

version 1.47, 2002/08/21 17:18:08 version 1.76, 2003/06/10 19:19:57
Line 1 Line 1
 # The LearningOnline Network with CAPA  # The LearningOnline Network with CAPA
 # (Publication Handler  
 #  #
 # $Id$  # $Id$
 #  #
Line 26 Line 25
 # http://www.lon-capa.org/  # http://www.lon-capa.org/
 #  #
 # (Navigate problems for statistical reports  # (Navigate problems for statistical reports
 # YEAR=2001  
 # 5/5,7/9,7/25/1,8/11,9/13,9/26,10/5,10/9,10/22,10/26 Behrouz Minaei  
 # 11/1,11/4,11/16,12/14,12/16,12/18,12/20,12/31 Behrouz Minaei  
 # YEAR=2002  
 # 1/22,2/1,2/6,2/25,3/2,3/6,3/17,3/21,3/22,3/26,4/7,5/6 Behrouz Minaei  
 # 5/12,5/14,5/15,5/19,5/26,7/16,25/7,29/7  Behrouz Minaei  
 #  #
 ###  ###
   
 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 HTML::TokeParser;  use Apache::lonpercentage;
 use GDBM_File;  use Apache::lonmysql;
   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
   
   =item @FullClasslist The full classlist
   
   =item @Students The students we are concerned with for this invocation
   
   =item @Sections The sections available in this class
   
   =item $curr_student The student currently being examined
   
   =item $prev_student The student previous in the classlist
   
   =item $next_student The student next in the classlist
   
   =over
   
   =cut 
   
   #######################################################
   #######################################################
   #
   # Classlist variables
   #
   my $curr_student;
   my $prev_student;
   my $next_student;
   
   #######################################################
   #######################################################
   
   =pod
   
   =item &clear_classlist_variables()
   
   undef the following package variables:
   
   =over
   
   =item @FullClasslist
   
   =item @Students
   
   =item @Sections
   
   =item @SelectedSections
   
   =item %StudentData
   
   =item @StudentDataOrder
   
   =item @SelectedStudentData
   
   =item $curr_student
   
   =item $prev_student
   
   =item $next_student
   
   =back
   
   =cut
   
   #######################################################
   #######################################################
   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);
 }  }
   
 sub ProcessFormData{  #######################################################
     my ($cache)=@_;  #######################################################
   
     $cache->{'reportKey'} = 'false';  =pod
   
     &Apache::loncommon::get_unprocessed_cgi($ENV{'QUERY_STRING'},  =item &PrepareClasslist()
                                             ['sort','download',  
                                              'reportSelected',  Build up the classlist information.  The classlist information is kept in
                                              'StudentAssessmentStudent',  the following package variables:
                                              'ProblemStatisticsSort']);  
     &CheckFormElement($cache, 'Status', 'Status', 'Active');  =over
     &CheckFormElement($cache, 'postdata', 'reportSelected', 'Class list');  
     &CheckFormElement($cache, 'reportSelected', 'reportSelected',   =item @FullClasslist
                       'Class list');  
     $cache->{'reportSelected'} =   =item @Students
         &Apache::lonnet::unescape($cache->{'reportSelected'});  
     &CheckFormElement($cache, 'DownloadAll', 'DownloadAll', 'false');  =item @Sections
     &CheckFormElement($cache, 'sort', 'sort', 'fullname');  
     &CheckFormElement($cache, 'download', 'download', 'false');  =item @SelectedSections
     &CheckFormElement($cache, 'StatisticsMaps',   
                       'StatisticsMaps', 'All Maps');  =item %StudentData
     if(defined($ENV{'form.Section'})) {  
         my @sectionsSelected = (ref($ENV{'form.Section'}) ?  =item @SelectedStudentData
                                @{$ENV{'form.Section'}} :  
                                 ($ENV{'form.Section'}));  =item $curr_student
         $cache->{'sectionsSelected'} = join(':', @sectionsSelected);  
     } elsif(!defined($cache->{'sectionsSelected'})) {  =item $prev_student
         $cache->{'sectionsSelected'} = $cache->{'sectionList'};  
     }  =item $next_student
   
     # student assessment  =back
     if(defined($ENV{'form.CreateStudentAssessment'}) ||  
        defined($ENV{'form.NextStudent'}) ||  $curr_student, $prev_student, and $next_student may not be defined, depending
        defined($ENV{'form.PreviousStudent'})) {  upon the calling context.
         $cache->{'reportSelected'} = 'Student Assessment';  
     }  =cut
     if(defined($ENV{'form.NextStudent'})) {  
         $cache->{'StudentAssessmentMove'} = 'next';  #######################################################
     } elsif(defined($ENV{'form.PreviousStudent'})) {  #######################################################
         $cache->{'StudentAssessmentMove'} = 'previous';  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 {      } else {
         $cache->{'StudentAssessmentMove'} = 'selected';          @Sections = sort {$a cmp $b} keys(%Sections);
           unshift(@Sections,'all'); # Put 'all' at the front of the list
     }      }
     &CheckFormElement($cache, 'StudentAssessmentStudent',       #
                       'StudentAssessmentStudent', 'All Students');      # Sort the Students
     $cache->{'StudentAssessmentStudent'} =       my $sortby = 'fullname';
         &Apache::lonnet::unescape($cache->{'StudentAssessmentStudent'});      $sortby = $ENV{'form.sort'} if (exists($ENV{'form.sort'}));
     &CheckFormElement($cache, 'DefaultColumns', 'DefaultColumns', 'false');      my @TmpStudents = sort { $a->{$sortby} cmp $b->{$sortby} ||
                                $a->{'fullname'} cmp $b->{'fullname'} } @Students;
     # Problem analysis      @Students = @TmpStudents;
     &CheckFormElement($cache, 'Interval', 'Interval', '1');      # 
       # Now deal with that current student thing....
     # ProblemStatistcs      $curr_student = undef;
     &CheckFormElement($cache, 'DisplayCSVFormat',      if (exists($ENV{'form.SelectedStudent'})) {
                       'DisplayFormat', 'Display Table Format');          my ($current_uname,$current_dom) = 
     &CheckFormElement($cache, 'ProblemStatisticsAscend',              split(':',$ENV{'form.SelectedStudent'});
                       'ProblemStatisticsAscend', 'Ascending');          my $i;
     &CheckFormElement($cache, 'ProblemStatisticsSort',          for ($i = 0; $i<=$#Students; $i++) {
                       'ProblemStatisticsSort', 'Homework Sets Order');              next if (($Students[$i]->{'username'} ne $current_uname) || 
     &CheckFormElement($cache, 'DisplayLegend', 'DisplayLegend', 'Hide Legend');                       ($Students[$i]->{'domain'}   ne $current_dom));
     &CheckFormElement($cache, 'SortProblems', 'SortProblems',               $curr_student = $Students[$i];
                       'Sort Within Sequence');              last; # If we get here, we have our student.
           }
     # Search only form elements          if (defined($curr_student)) {
     my @headingColumns=();              if ($i == 0) {
     my @sequenceColumns=();                  $prev_student = undef;
     my $foundColumn = 0;              } else {
     if(defined($ENV{'form.ReselectColumns'})) {                  $prev_student = $Students[$i-1];
         my @reselected = (ref($ENV{'form.ReselectColumns'}) ?               }
                           @{$ENV{'form.ReselectColumns'}}              if ($i == $#Students) {
                           : ($ENV{'form.ReselectColumns'}));                  $next_student = undef;
         foreach (@reselected) {              } else {
             if(/HeadingColumn/) {                  $next_student = $Students[$i+1];
                 push(@headingColumns, $_);  
                 $foundColumn = 1;  
             } elsif(/SequenceColumn/) {  
                 push(@sequenceColumns, $_);  
                 $foundColumn = 1;  
             }              }
         }          }
     }      }
       #
     $cache->{'reportKey'} = 'false';      if (exists($ENV{'form.StudentData'})) {
     if($cache->{'reportSelected'} eq 'Analyze') {          if (ref($ENV{'form.StudentData'}) eq 'ARRAY') {
         $cache->{'reportKey'} = 'Analyze';              @SelectedStudentData = @{$ENV{'form.StudentData'}};
     } elsif($cache->{'reportSelected'} eq 'DoDiffGraph') {          } else {
         $cache->{'reportKey'} = 'DoDiffGraph';              @SelectedStudentData = ($ENV{'form.StudentData'});
     } elsif($cache->{'reportSelected'} eq 'PercentWrongGraph') {  
         $cache->{'reportKey'} = 'PercentWrongGraph';  
     }  
   
     if(defined($ENV{'form.DoDiffGraph'})) {  
         $cache->{'reportSelected'} = 'DoDiffGraph';  
         $cache->{'reportKey'} = 'DoDiffGraph';  
     } elsif(defined($ENV{'form.PercentWrongGraph'})) {  
         $cache->{'reportSelected'} = 'PercentWrongGraph';  
         $cache->{'reportKey'} = 'PercentWrongGraph';  
     }  
   
     foreach (keys(%ENV)) {  
         if(/form\.Analyze/) {  
             $cache->{'reportSelected'} = 'Analyze';  
             $cache->{'reportKey'} = 'Analyze';  
             my $data;  
             (undef, $data)=split(':::', $_);  
             $cache->{'AnalyzeInfo'}=$data;  
         } elsif(/form\.HeadingColumn/) {  
             my $value = $_;  
             $value =~ s/form\.//;  
             push(@headingColumns, $value);  
             $foundColumn=1;  
         } elsif(/form\.SequenceColumn/) {  
             my $value = $_;  
             $value =~ s/form\.//;  
             push(@sequenceColumns, $value);  
             $foundColumn=1;  
         }          }
       } else {
           @SelectedStudentData = ('username');
     }      }
       foreach (@SelectedStudentData) {
     if($foundColumn) {          if ($_ eq 'all') {
         $cache->{'HeadingsFound'} = join(':', @headingColumns);              @SelectedStudentData = ('all');
         $cache->{'SequencesFound'} = join(':', @sequenceColumns);;              last;
     }          }
     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;      return;
 }  }
   
 =pod  
   
 =item &SortStudents()  #######################################################
   #######################################################
   
 Determines which students to display and in which order.  Which are   =pod
 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  =item get_students
   
 Input: $students, $CacheData  Returns a list of the selected students
   
 $students: A array pointer to a list of students (username:domain)  =cut
   
 $CacheData: A pointer to the hash tied to the cached data  #######################################################
   #######################################################
   sub get_students {
       if (! @Students) {
           &PrepareClasslist()
       }
       return @Students;
   }
   
 Output: \@order  #######################################################
   #######################################################
   
 @order: An ordered list of students (username:domain)  =pod
   
 =back  =item &current_student()
   
   Returns a pointer to a hash containing data about the currently
   selected student.
   
 =cut  =cut
   
 sub SortStudents {  #######################################################
     my ($cache)=@_;  #######################################################
   sub current_student { 
       return $curr_student;
   }
   
     my @students = split(':::',$cache->{'NamesOfStudents'});  #######################################################
     my @sorted1Students=();  #######################################################
     foreach (@students) {  
         if($cache->{'Status'} eq 'Any' ||   
            $cache->{$_.':Status'} eq $cache->{'Status'}) {  
             push(@sorted1Students, $_);  
         }  
     }  
   
     my $sortBy = '';  =pod
     if(defined($cache->{'sort'})) {  
         $sortBy = ':'.$cache->{'sort'};  =item &previous_student()
     }  
     my @order = sort { $cache->{$a.$sortBy} cmp $cache->{$b.$sortBy} ||  Returns a pointer to a hash containing data about the student prior
                        $cache->{$a.':fullname'} cmp $cache->{$b.':fullname'} }   in the list of students.  Or something.  
                 @sorted1Students;  
   
     return \@order;  =cut
   
   #######################################################
   #######################################################
   sub previous_student { 
       return $prev_student;
 }  }
   
   #######################################################
   #######################################################
   
 =pod  =pod
   
 =item &SpaceColumns()  =item &next_student()
   
 Determines the width of all the columns in the chart.  It is based on  Returns a pointer to a hash containing data about the next student
 the max of the data for that column and its header.  to be viewed.
   
 =over 4  =cut
   
 Input: $students, $studentInformation, $headings, $ChartDB  #######################################################
   #######################################################
   sub next_student { 
       return $next_student;
   }
   
 $students: An array pointer to a list of students (username:domain)  #######################################################
   #######################################################
   
 $studentInformatin: The type of data for the student information.  It is  =pod
 used as part of the key in $CacheData.  
   
 $headings: The name of the student information columns.  =item &clear_sequence_variables()
   
 $ChartDB: The name of the cache database which is opened for read/write.  =cut
   
 Output: None - All data stored in cache.  #######################################################
   #######################################################
   sub clear_sequence_variables {
       undef($top_map);
       undef(@Sequences);
       undef(@Assessments);
   }
   
 =back  #######################################################
   #######################################################
   
 =cut  =pod
   
 sub SpaceColumns {  =item &SetSelectedMaps($elementname)
     my ($students,$studentInformation,$headings,$cache)=@_;  
   
     # Initialize Lengths  Sets the @SelectedMaps array from $ENV{'form.'.$elementname};
     for(my $index=0; $index<(scalar @$headings); $index++) {  
         my @titleLength=split(//,$headings->[$index]);  =cut
         $cache->{$studentInformation->[$index].':columnWidth'}=  
             scalar @titleLength;  #######################################################
     }  #######################################################
   sub SetSelectedMaps {
     foreach my $name (@$students) {      my $elementname = shift;
         foreach (@$studentInformation) {      if (exists($ENV{'form.'.$elementname})) {
             my @dataLength=split(//,$cache->{$name.':'.$_});          if (ref($ENV{'form.'.$elementname})) {
             my $length=(scalar @dataLength);              @SelectedMaps = @{$ENV{'form.'.$elementname}};
             if($length > $cache->{$_.':columnWidth'}) {          } else {
                 $cache->{$_.':columnWidth'}=$length;              @SelectedMaps = ($ENV{'form.'.$elementname});
             }  
         }          }
       } else {
           @SelectedMaps = ('all');
     }      }
   
     return;  
 }  }
   
 sub PrepareData {  
     my ($c, $cacheDB, $studentInformation, $headings,$r)=@_;  
   
     # 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)) {  Returns an array containing the subset of @Sequences which contain
         return "Unable to tie hash to db file.";  assessments.
     }  
   
     if(!$isCached) {  =cut
         my $processTopResourceMapReturn=  
             &Apache::loncoursedata::ProcessTopResourceMap(\%cache, $c, $r);  #######################################################
         if($processTopResourceMapReturn ne 'OK') {  #######################################################
             untie(%cache);  sub Sequences_with_Assess {
             return $processTopResourceMapReturn;      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';   
     }  
   
     my $classlist=&Apache::loncoursedata::DownloadClasslist($courseID,  =pod
                                                 $cache{'ClasslistTimestamp'},  
                                                 $c);  =item &PrepareCourseData($r)
     foreach (keys(%$classlist)) {  
         if(/^(con_lost|error|no_such_host)/i) {  =cut
             untie(%cache);  
             return "Error getting student data.";  #######################################################
   #######################################################
   sub PrepareCourseData {
       my ($r) = @_;
       &clear_sequence_variables();
       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));
       @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
         $cache{'download'} = 'false';  calls.
         if(&Apache::loncoursedata::DownloadStudentCourseData(\@who, 'false',   
                                                              $cacheDB, 'true',   =cut
                                                              'false', $courseID,  
                                                              $r, $c) ne 'OK') {  #######################################################
             untie(%cache);  #######################################################
             return 'Stop at download individual';  sub log_sequence {
         }      my ($seq,$recursive,$padding) = @_;
     } elsif($cache{'DownloadAll'} ne 'false') {      $padding = '' if (! defined($padding));
         $cache{'DownloadAll'} = 'false';      if (ref($seq) ne 'HASH') {
         my @allStudents;          &Apache::lonnet::logthis('log_sequence passed bad sequnce');
         if($cache{'DownloadAll'} eq 'sorted') {          return;
             @allStudents = @$students;      }
       &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);
         }          }
         if(&Apache::loncoursedata::DownloadStudentCourseData(\@allStudents,       }
                                                              'false',       if (defined($recursive)) {
                                                              $cacheDB, 'true',           &Apache::lonnet::logthis($padding.'-'x20);
                                                              'true', $courseID,          &Apache::lonnet::logthis($padding.'contains:');
                                                              $r, $c) ne 'OK') {          foreach my $item (@{$seq->{'contents'}}) {
             untie(%cache);              if ($item->{'type'} eq 'container') {
             return 'Stop at download all';                  &log_sequence($item,$recursive,$padding.'    ');
               } else {
                   &Apache::lonnet::logthis($padding.'title = '.$item->{'title'});
                   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);
                       }
                   }
               }
         }          }
           &Apache::lonnet::logthis($padding.'end contents of '.$seq->{'title'});
           &Apache::lonnet::logthis($padding.'-'x20);
     }      }
       return;
   }
   
   ##############################################
   ##############################################
   
     if($c->aborted()) {  =pod 
         untie(%cache);  
         return 'aborted';   =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)
   
   =over 4
   
   =item $elementname The name of the HTML form element
   
   =item $status 'multiple' or 'single' selection box
   
   =item $numvisible The number of options to be visible
   
   =back
   
   =cut
   
   ##############################################
   ##############################################
   sub StudentDataSelect {
       my ($elementname,$status,$numvisible)=@_;
       if ($numvisible < 1) {
           return;
       }
       #
       # 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'
       $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;
   }
   
   ##############################################
   ##############################################
   
   =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.
   
     untie(%cache);  =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
   
     return ('OK', $students);  ##############################################
   ##############################################
   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,$r)=@_;  ##############################################
   
     my %cache;  =pod 
     unless(tie(%cache,'GDBM_File',$cacheDB,&GDBM_READER(),0640)) {  
         return '<html><body>Unable to tie database.</body></html>';  =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
   
   =item $elementname The name of the HTML form element
   
   =item $status 'multiple' or 'single' selection box
   
   =item $numvisible The number of options to be visible
   
   =back
   
   =cut
   
   ##############################################
   ##############################################
   sub 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='';
       # "Click" is asinine but it is probably not my place to change the world.
       $Str .= '<h2>Click on a users name 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;      my $alternate = 0;
     foreach (@$students) {      foreach my $student (@Students) { # @Students is a package variable
         my ($username, $domain) = split(':', $_);          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') {
                 $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";
       #
     $r->print($Str);      $r->print($Str);
     $r->rflush();      $r->rflush();
       #
     untie(%cache);  
   
     return;      return;
 }  }
   
   ##############################################
   ##############################################
 sub CreateMainMenu {  sub CreateMainMenu {
     my ($status, $reports)=@_;      my ($status,$reports,$current)=@_;
       #
     my $Str = '';      my $Str = '';
       #
     $Str .= '<table border="0"><tbody><tr>'."\n";      $Str .= '<table border="0"><tbody><tr>'."\n";
     $Str .= '<td></td><td></td>'."\n";      $Str .= '<td align="center"><b>Report:</b></td>'."\n";
     $Str .= '<td align="center"><b>Analysis Reports:</b></td>'."\n";  
     $Str .= '<td align="center"><b>Student Status:</b></td></tr>'."\n";  
     $Str .= '<tr>'."\n";  
     $Str .= '<td align="center"><input type="submit" name="Refresh" ';  
     $Str .= 'value="Refresh" /></td>'."\n";  
     $Str .= '<td align="center"><input type="submit" name="DownloadAll" ';  
     $Str .= 'value="Update All Student Data" /></td>'."\n";  
     $Str .= '<td align="center">';      $Str .= '<td align="center">';
     $Str .= '<select name="reportSelected" onchange="document.';      $Str .= '<select name="reportSelected" '.
     $Str .= 'Statistics.submit()">'."\n";          'onchange="document.Statistics.submit()">'."\n";
   
     foreach (sort(keys(%$reports))) {      foreach (sort(keys(%$reports))) {
         next if($_ eq 'reportSelected');          $Str .= '<option value="'.$_.'"';
         $Str .= '<option name="'.$_.'"';          if($current eq $_) {
         if($reports->{'reportSelected'} eq $reports->{$_}) {              $Str .= ' selected';
             $Str .= ' selected=""';  
         }          }
         $Str .= '>'.$reports->{$_}.'</option>'."\n";          $Str .= '>'.$reports->{$_}.'</option>'."\n";
     }      }
     $Str .= '</select></td>'."\n";      $Str .= '</select></td>'."\n";
       #
     $Str .= '<td align="center">';      $Str .= '<td>'.('&nbsp;'x30).'</td>';
     $Str .= &Apache::lonhtmlcommon::StatusOptions($status, 'Statistics');      $Str .= '<td align="center">'.
     $Str .= '</td>'."\n";          '<input type="submit" name="ClearCache" value="Clear Caches" />'.
               "</td>\n";
     $Str .= '</tr></tbody></table>'."\n";      $Str .= '</tr></tbody></table>'."\n";
     $Str .= '<hr>'."\n";      $Str .= '<hr>'."\n";
       #
     return $Str;      return $Str;
 }  }
   
 sub BuildStatistics {  ##############################################
     my ($r)=@_;  ##############################################
   
     my $c = $r->connection;  
     my @studentInformation=('fullname','section','id','domain','username',  
                             'updateTime');  
     my @headings=('Full Name', 'Section', 'PID', 'Domain', 'User Name',  
                   'Last Updated');  
     my $spacing = '   ';  
     my %reports = ('classlist'          => 'Class list',  
                    'problem_statistics' => 'Problem Statistics',  
                    'student_assessment' => 'Student Assessment',  
 #                   'activitylog'        => 'Activity Log',  
                    'reportSelected'     => 'Class list');  
   
     my %cache;  
     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') {  
         &BuildClasslist($cacheDB, $students, \@studentInformation,  
                         \@headings, $r);  
     }  
   
     $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();
 #    $jr = $r;      #
       # Check for overloading
     unless(&Apache::lonnet::allowed('vgr',$ENV{'request.course.id'})) {      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 620  sub handler { Line 918  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 'classlist') {
           &DisplayClasslist($r);
       } 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.47  
changed lines
  Added in v.1.76

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