[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.68

version 1.47, 2002/08/21 17:18:08 version 1.68, 2003/05/12 22:07:17
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
 }  
   
 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',  
                                              'ProblemStatisticsSort']);  
     &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');  
     &CheckFormElement($cache, 'StatisticsMaps',   
                       'StatisticsMaps', 'All Maps');  
     if(defined($ENV{'form.Section'})) {  
         my @sectionsSelected = (ref($ENV{'form.Section'}) ?  
                                @{$ENV{'form.Section'}} :  
                                 ($ENV{'form.Section'}));  
         $cache->{'sectionsSelected'} = join(':', @sectionsSelected);  
     } elsif(!defined($cache->{'sectionsSelected'})) {  
         $cache->{'sectionsSelected'} = $cache->{'sectionList'};  
     }  
   
     # student assessment  
     if(defined($ENV{'form.CreateStudentAssessment'}) ||  
        defined($ENV{'form.NextStudent'}) ||  
        defined($ENV{'form.PreviousStudent'})) {  
         $cache->{'reportSelected'} = 'Student Assessment';  
     }  
     if(defined($ENV{'form.NextStudent'})) {  
         $cache->{'StudentAssessmentMove'} = 'next';  
     } elsif(defined($ENV{'form.PreviousStudent'})) {  
         $cache->{'StudentAssessmentMove'} = 'previous';  
     } else {  
         $cache->{'StudentAssessmentMove'} = 'selected';  
     }  
     &CheckFormElement($cache, 'StudentAssessmentStudent',   
                       'StudentAssessmentStudent', 'All Students');  
     $cache->{'StudentAssessmentStudent'} =   
         &Apache::lonnet::unescape($cache->{'StudentAssessmentStudent'});  
     &CheckFormElement($cache, 'DefaultColumns', 'DefaultColumns', 'false');  
   
     # Problem analysis  
     &CheckFormElement($cache, 'Interval', 'Interval', '1');  
   
     # ProblemStatistcs  
     &CheckFormElement($cache, 'DisplayCSVFormat',  
                       'DisplayFormat', 'Display Table Format');  
     &CheckFormElement($cache, 'ProblemStatisticsAscend',  
                       'ProblemStatisticsAscend', 'Ascending');  
     &CheckFormElement($cache, 'ProblemStatisticsSort',  
                       'ProblemStatisticsSort', 'Homework Sets Order');  
     &CheckFormElement($cache, 'DisplayLegend', 'DisplayLegend', 'Hide Legend');  
     &CheckFormElement($cache, 'SortProblems', 'SortProblems',   
                       'Sort Within Sequence');  
   
     # Search only form elements  
     my @headingColumns=();  
     my @sequenceColumns=();  
     my $foundColumn = 0;  
     if(defined($ENV{'form.ReselectColumns'})) {  
         my @reselected = (ref($ENV{'form.ReselectColumns'}) ?   
                           @{$ENV{'form.ReselectColumns'}}  
                           : ($ENV{'form.ReselectColumns'}));  
         foreach (@reselected) {  
             if(/HeadingColumn/) {  
                 push(@headingColumns, $_);  
                 $foundColumn = 1;  
             } elsif(/SequenceColumn/) {  
                 push(@sequenceColumns, $_);  
                 $foundColumn = 1;  
             }  
         }  
     }  
   
     $cache->{'reportKey'} = 'false';  =item $curr_student The student currently being examined
     if($cache->{'reportSelected'} eq 'Analyze') {  
         $cache->{'reportKey'} = 'Analyze';  
     } elsif($cache->{'reportSelected'} eq 'DoDiffGraph') {  
         $cache->{'reportKey'} = 'DoDiffGraph';  
     } elsif($cache->{'reportSelected'} eq 'PercentWrongGraph') {  
         $cache->{'reportKey'} = 'PercentWrongGraph';  
     }  
   
     if(defined($ENV{'form.DoDiffGraph'})) {  
         $cache->{'reportSelected'} = 'DoDiffGraph';  
         $cache->{'reportKey'} = 'DoDiffGraph';  
     } elsif(defined($ENV{'form.PercentWrongGraph'})) {  
         $cache->{'reportSelected'} = 'PercentWrongGraph';  
         $cache->{'reportKey'} = 'PercentWrongGraph';  
     }  
   
     foreach (keys(%ENV)) {  
         if(/form\.Analyze/) {  
             $cache->{'reportSelected'} = 'Analyze';  
             $cache->{'reportKey'} = 'Analyze';  
             my $data;  
             (undef, $data)=split(':::', $_);  
             $cache->{'AnalyzeInfo'}=$data;  
         } elsif(/form\.HeadingColumn/) {  
             my $value = $_;  
             $value =~ s/form\.//;  
             push(@headingColumns, $value);  
             $foundColumn=1;  
         } elsif(/form\.SequenceColumn/) {  
             my $value = $_;  
             $value =~ s/form\.//;  
             push(@sequenceColumns, $value);  
             $foundColumn=1;  
         }  
     }  
   
     if($foundColumn) {  =item $prev_student The student previous in the classlist
         $cache->{'HeadingsFound'} = join(':', @headingColumns);  
         $cache->{'SequencesFound'} = join(':', @sequenceColumns);;  
     }  
     if(!defined($cache->{'HeadingsFound'}) ||   
        $cache->{'DefaultColumns'} ne 'false') {  
         $cache->{'HeadingsFound'}='HeadingColumnFull Name';  
     }  
     if(!defined($cache->{'SequencesFound'}) ||  
        $cache->{'DefaultColumns'} ne 'false') {  
         $cache->{'SequencesFound'}='All Sequences';  
     }  
     $cache->{'DefaultColumns'} = 'false';  
   
     return;  =item $next_student The student next in the classlist
 }  
   =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
   
 Input: $students, $CacheData  =item @FullClasslist
   
 $students: A array pointer to a list of students (username:domain)  =item @Students
   
 $CacheData: A pointer to the hash tied to the cached data  =item @Sections
   
 Output: \@order  =item @SelectedSections
   
 @order: An ordered list of students (username:domain)  =item %StudentData
   
 =back  =item @StudentDataOrder
   
 =cut  =item @SelectedStudentData
   
 sub SortStudents {  =item $curr_student
     my ($cache)=@_;  
   
     my @students = split(':::',$cache->{'NamesOfStudents'});  =item $prev_student
     my @sorted1Students=();  
     foreach (@students) {  
         if($cache->{'Status'} eq 'Any' ||   
            $cache->{$_.':Status'} eq $cache->{'Status'}) {  
             push(@sorted1Students, $_);  
         }  
     }  
   
     my $sortBy = '';  =item $next_student
     if(defined($cache->{'sort'})) {  
         $sortBy = ':'.$cache->{'sort'};  =back
     }  
     my @order = sort { $cache->{$a.$sortBy} cmp $cache->{$b.$sortBy} ||  =cut
                        $cache->{$a.':fullname'} cmp $cache->{$b.':fullname'} }   
                 @sorted1Students;  
   
     return \@order;  #######################################################
   #######################################################
   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  =pod
   
 =item &SpaceColumns()  =item &PrepareClasslist()
   
 Determines the width of all the columns in the chart.  It is based on  Build up the classlist information.  The classlist information is kept in
 the max of the data for that column and its header.  the following package variables:
   
 =over 4  =over
   
   =item @FullClasslist
   
 Input: $students, $studentInformation, $headings, $ChartDB  =item @Students
   
 $students: An array pointer to a list of students (username:domain)  =item @Sections
   
 $studentInformatin: The type of data for the student information.  It is  =item @SelectedSections
 used as part of the key in $CacheData.  
   
 $headings: The name of the student information columns.  =item %StudentData
   
 $ChartDB: The name of the cache database which is opened for read/write.  =item @SelectedStudentData
   
 Output: None - All data stored in cache.  =item $curr_student
   
   =item $prev_student
   
   =item $next_student
   
 =back  =back
   
 =cut  $curr_student, $prev_student, and $next_student may not be defined, depending
   upon the calling context.
   
 sub SpaceColumns {  =cut
     my ($students,$studentInformation,$headings,$cache)=@_;  
   
     # Initialize Lengths  #######################################################
     for(my $index=0; $index<(scalar @$headings); $index++) {  #######################################################
         my @titleLength=split(//,$headings->[$index]);  sub PrepareClasslist {
         $cache->{$studentInformation->[$index].':columnWidth'}=      my $r = shift;
             scalar @titleLength;      my %Sections;
     }      &clear_classlist_variables();
       #
     foreach my $name (@$students) {      # Retrieve the classlist
         foreach (@$studentInformation) {      my $cid  = $ENV{'request.course.id'};
             my @dataLength=split(//,$cache->{$name.':'.$_});      my $cdom = $ENV{'course.'.$cid.'.domain'};
             my $length=(scalar @dataLength);      my $cnum = $ENV{'course.'.$cid.'.num'};
             if($length > $cache->{$_.':columnWidth'}) {      my ($classlist,$field_names) = &Apache::loncoursedata::get_classlist($cid,
                 $cache->{$_.':columnWidth'}=$length;                                                                    $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');
           }
       }
       #
       # 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
       @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....
       if (exists($ENV{'form.StudentAssessmentStudent'})) {
           my ($current_uname,$current_dom) = 
               split(':',$ENV{'form.StudentAssessmentStudent'});
           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 ($i == 0) {
               $prev_student = 'none';
           } else {
               $prev_student = $Students[$i-1];
           }
           if ($i == $#Students) {
               $next_student = 'none';
           } 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 = ('fullname');
       }
       foreach (@SelectedStudentData) {
           if ($_ eq 'all') {
               @SelectedStudentData = ('all');
               last;
           }
       }
       #
     return;      return;
 }  }
   
 sub PrepareData {  #######################################################
     my ($c, $cacheDB, $studentInformation, $headings,$r)=@_;  #######################################################
   
   =pod
   
   =item &current_student()
   
   Returns a pointer to a hash containing data about the currently
   selected student.
   
   =cut
   
     # Test for access to the cache data  #######################################################
     my $courseID=$ENV{'request.course.id'};  #######################################################
     my $isRecalculate=0;  sub current_student { 
     if(defined($ENV{'form.Recalculate'})) {      if (defined($curr_student)) {
         $isRecalculate=1;          return $curr_student;
       } else {
           return 'All Students';
     }      }
   }
   
     my $isCached = &Apache::loncoursedata::TestCacheData($cacheDB,   #######################################################
                                                          $isRecalculate);  #######################################################
     if($isCached < 0) {  
         return "Unable to tie hash to db file.";  =pod
   
   =item &previous_student()
   
   Returns a pointer to a hash containing data about the student prior
   in the list of students.  Or something.  
   
   =cut
   
   #######################################################
   #######################################################
   sub previous_student { 
       if (defined($prev_student)) {
           return $prev_student;
       } else {
           return 'No Student Selected';
     }      }
   }
   
   #######################################################
   #######################################################
   
     # Download class list information if not using cached data  =pod
     my %cache;  
     unless(tie(%cache,'GDBM_File',$cacheDB,&GDBM_WRCREAT(),0640)) {  =item &next_student()
         return "Unable to tie hash to db file.";  
   Returns a pointer to a hash containing data about the next student
   to be viewed.
   
   =cut
   
   #######################################################
   #######################################################
   sub next_student { 
       if (defined($next_student)) {
           return $next_student;
       } else {
           return 'No Student Selected';
     }      }
   }
   
   #######################################################
   #######################################################
   
   =pod
   
   =item &clear_sequence_variables()
   
   =cut
   
   #######################################################
   #######################################################
   sub clear_sequence_variables {
       undef($top_map);
       undef(@Sequences);
       undef(@Assessments);
   }
   
     if(!$isCached) {  #######################################################
         my $processTopResourceMapReturn=  #######################################################
             &Apache::loncoursedata::ProcessTopResourceMap(\%cache, $c, $r);  
         if($processTopResourceMapReturn ne 'OK') {  =pod
             untie(%cache);  
             return $processTopResourceMapReturn;  =item &SetSelectedMaps($elementname)
   
   Sets the @SelectedMaps array from $ENV{'form.'.$elementname};
   
   =cut
   
   #######################################################
   #######################################################
   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');
     }      }
   }
   
     if($c->aborted()) {  
         untie(%cache);  
         return 'aborted';   
     }  
   
     my $classlist=&Apache::loncoursedata::DownloadClasslist($courseID,  #######################################################
                                                 $cache{'ClasslistTimestamp'},  #######################################################
                                                 $c);  
     foreach (keys(%$classlist)) {  =pod
         if(/^(con_lost|error|no_such_host)/i) {  
             untie(%cache);  =item &Sequences_with_Assess()
             return "Error getting student data.";  
   Returns an array containing the subset of @Sequences which contain
   assessments.
   
   =cut
   
   #######################################################
   #######################################################
   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';   
     }  
   
     # 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 &PrepareCourseData($r)
     my $students = &SortStudents(\%cache);  
     &SpaceColumns($students, $studentInformation, $headings, \%cache);  =cut
     $cache{'updateTime:columnWidth'}=24;  
   
     if($cache{'download'} ne 'false') {  #######################################################
         my @who = ($cache{'download'});  #######################################################
         $cache{'download'} = 'false';  sub PrepareCourseData {
         if(&Apache::loncoursedata::DownloadStudentCourseData(\@who, 'false',       my ($r) = @_;
                                                              $cacheDB, 'true',       &clear_sequence_variables();
                                                              'false', $courseID,      my ($top,$sequences,$assessments) = 
                                                              $r, $c) ne 'OK') {          &Apache::loncoursedata::get_sequence_assessment_data();
             untie(%cache);      if (! defined($top) || ! ref($top)) {
             return 'Stop at download individual';          # 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'};
           #
           # The number of columns needed for the summation text: 
           #    " 1/5" = 1+3 columns, " 10/99" = 1+5 columns
           my $sum_length = 1+1+2*(length($num_parts));
           my $num_col = $num_parts+$sum_length;
           if ($num_col < $name_length) {
               $num_col = $name_length;
         }          }
     } elsif($cache{'DownloadAll'} ne 'false') {          $seq->{'base_width'} = $name_length;
         $cache{'DownloadAll'} = 'false';          $seq->{'width'} = $num_col;
         my @allStudents;      }
         if($cache{'DownloadAll'} eq 'sorted') {      return;
             @allStudents = @$students;  }
   
   #######################################################
   #######################################################
   
   =pod
   
   =item &log_sequence($sequence,$recursive,$padding)
   
   Write data about the sequence to a logfile.  If $recursive is not
   undef the data is written recursively.  $padding is used for recursive
   calls.
   
   =cut
   
   #######################################################
   #######################################################
   sub log_sequence {
       my ($seq,$recursive,$padding) = @_;
       $padding = '' if (! defined($padding));
       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);
         }          }
         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;
   }
   
   ##############################################
   ##############################################
   
   =pod 
   
   =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
   
     if($c->aborted()) {  =item $numvisible The number of options to be visible
         untie(%cache);  
         return 'aborted';   =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.
   
   =over 4
   
   =item $elementname The name of the HTML form element
   
     untie(%cache);  =item $status 'multiple' or 'single' selection box
   
     return ('OK', $students);  =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,$r)=@_;  ##############################################
   
   =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.  
   
   =over 4
   
   =item $elementname The name of the HTML form element
   
     my %cache;  =item $status 'multiple' or 'single' selection box
     unless(tie(%cache,'GDBM_File',$cacheDB,&GDBM_READER(),0640)) {  
         return '<html><body>Unable to tie database.</body></html>';  =item $numvisible The number of options to be visible
   
   =item $selected Array ref to the names of the already selected sections.
   If undef, $ENV{'form.'.$elementname} is used.  
   If $ENV{'form.'.$elementname} is also empty, none will be selected.
   
   =item $restriction Code reference to subroutine which returns true or 
   false.  The code must expect a reference to a sequence data structure.
   
   =back
   
   =cut
   
   ##############################################
   ##############################################
   sub SectionSelect {
       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";
       #
       # 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='';
     $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 .= '&StudentAssessmentStudent=';
                 $Str .= &Apache::lonnet::escape($cache{$_.':'.$data}).'">';                  $Str .= &Apache::lonnet::escape($sname).'">';
                 $Str .= $cache{$_.':'.$data}.'&nbsp';                  $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></td>'."\n";
     $Str .= '<td align="center"><b>Analysis Reports:</b></td>'."\n";      $Str .= '<td></td>'."\n";
     $Str .= '<td align="center"><b>Student Status:</b></td></tr>'."\n";      $Str .= '<td align="center"><b>Select a Report</b></td>'."\n";
     $Str .= '<tr>'."\n";      $Str .= '<tr>'."\n";
     $Str .= '<td align="center"><input type="submit" name="Refresh" ';      #
     $Str .= 'value="Refresh" /></td>'."\n";      $Str .= '<td align="center">'.
     $Str .= '<td align="center"><input type="submit" name="DownloadAll" ';          '<input type="submit" name="Refresh" value="Update Display" />'.
     $Str .= 'value="Update All Student Data" /></td>'."\n";              "</td>\n";
       $Str .= '<td align="center">'.
           '<input type="submit" name="ClearCache" value="Clear Caches" />'.
               "</td>\n";
       #
     $Str .= '<td align="center">';      $Str .= '<td align="center">';
     $Str .= '<select name="reportSelected" onchange="document.';      $Str .= '<select name="reportSelected" >'."\n";
     $Str .= '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 .= &Apache::lonhtmlcommon::StatusOptions($status, 'Statistics');  
     $Str .= '</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
       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
     unless(&Apache::lonnet::allowed('vgr',$ENV{'request.course.id'})) {      unless(&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;           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 900  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',
                                                'StudentAssessmentStudent']);
       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($r);
       &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.68

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