Diff for /loncom/interface/lonstatistics.pm between versions 1.5 and 1.145

version 1.5, 2002/03/02 01:42:42 version 1.145, 2008/12/03 11:47:30
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/05,7/09,7/25/01,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 Behrouz Minaei  
 ###  ###
   
 package Apache::lonstatistics;   
   
   package Apache::lonstatistics;
   
 use strict;  use strict;
 use Apache::Constants qw(:common :http);  use Apache::Constants qw(:common :http);
 use Apache::lonnet();  use vars qw(
       @FullClasslist 
       @Students
       @Sections
       @Groups 
       %StudentData
       @StudentDataOrder
       @SelectedStudentData
       $enrollment_status);
   
   use Apache::lonnet;
 use Apache::lonhomework;  use Apache::lonhomework;
 use HTML::TokeParser;  use Apache::loncommon;
 use GDBM_File;  use Apache::loncoursedata;
 #use Benchmark;  use Apache::lonhtmlcommon;
   use Apache::lonmysql;
 # -------------------------------------------------------------- Module Globals  use Apache::lonlocal;
 my %hash;  use Apache::longroup;
 my %CachData;  use Time::HiRes;
 my %GraphDat;  #
 my %maps;  # Statistics Packages
 my %mapsort;  use Apache::lonproblemanalysis();
 my %section;  use Apache::lonsubmissiontimeanalysis();
 my %StuBox;  use Apache::loncorrectproblemplot();
 my %DiscFac;  use Apache::lonproblemstatistics();
 my $CurMap;  use Apache::lonstudentassessment();
 my $CurSec;  use Apache::lonpercentage;
 my $CurStu;  use Apache::lonstudentsubmissions();
 my @cols;  use Apache::lonsurveyreports();
 my @list;  use Apache::longradinganalysis();
 my @students;  use LONCAPA;
 my $p_count;  
 my $Pos;  #
 my $r;  # Classlist variables
 my $OpSel1;  #
 my $OpSel2;  my $curr_student;
 my $OpSelDis1;  my $prev_student;
 my $OpSelDis2;  my $next_student;
 my $CurDis=0;  
 my $OpSel3;  
 my $OpSel4;  
 my $GData;  
 my $cid;  
 my $firstres;  
 my $lastres;  
 my $DiscFlag;  
 my $HWN;  
 my $P_Order;  
 my %Header = (0,"Homework Problems",1,"#Stdnts",2,"Tries",3,"Mod",  
               4,"Mean",5,"#YES",6,"#yes",7,"%Wrng",8,"DoDiff",  
               9,"S.D.",10,"Skew.",11,"Map");  
 #             11,"Dis.F.",12,"Resourse URL");  
   
 sub NumericSort {            sub clear_classlist_variables {
     $a <=> $b;      undef(@FullClasslist);
       undef(@Students);
       undef(@Sections);
       undef(@Groups);
       undef(%StudentData);
       undef(@SelectedStudentData);
       undef($curr_student);
       undef($prev_student);
       undef($next_student);
 }  }
   
 # ------ Create different Student Report   
 sub StudentReport {  
     my ($sname,$sdom)=@_;  
     if ( $sname eq 'All Students' ) {  
  $r->print( '<h3><font color=blue>WARNING:   
                     Please select a student</font></h3>' );  
  return;  
     }  
     my $shome=&Apache::lonnet::homeserver( $sname,$sdom );            
     my $reply=&Apache::lonnet::reply('dump:'.$sdom.':'.$sname.':'.$cid,$shome );  
     my %result = ();  
     my $ResId;  
     my $PrOrd;  
     my $Code;  
     my $Tries;  
     my $TotalTries = 0;  
     my $ParCr = 0;  
     my $Wrongs;  
     my %TempHash;  
     my $Version;  
     my $LatestVersion;  
     my $PtrTry='';  
     my $PtrCod='';  
     my $SetNo=0;  
     my $Str = "\n".'<table border=2>'.  
               "\n".'<tr>'.  
               "\n".'<th> # </th>'.  
       "\n".'<th> Set Title </th>'.  
       "\n".'<th> Results </th>'.  
       "\n".'<th> Tries </th>'.  
       "\n".'</tr>';  
     unless ($reply=~/^error\:/) {  
         foreach (split(/\&/,$reply)){  
             my ($name,$value)=split(/\=/,&Apache::lonnet::unescape($_));  
             $result{$name}=$value;  
         }  
         foreach my $CurCol (@cols) {  
     if (!$CurCol){  
  my $Set=&Apache::lonnet::declutter($hash{'map_id_'.$1});  
  if ( $Set ) {  
     $SetNo++;  
     $Str .= "\n"."<tr>".  
     "\n"."<td> $SetNo </td>".  
                             "\n"."<td> $Set </td>".  
                             "\n"."<td> $PtrCod </td>".  
                             "\n"."<td> $PtrTry</td>".  
                             "\n"."</tr>";  
  }  
  $PtrTry='';  
  $PtrCod='';  
  next;   
     }  
     ($PrOrd,$ResId)=split(/\:/,$CurCol);  
             $ResId=~/(\d+)\.(\d+)/;  
             my $Map = &Apache::lonnet::declutter( $hash{'map_id_'.$1} );  
             if ( $CurMap ne 'All Maps' ) {  
  my ( $ResMap, $NameMap ) = split(/\=/,$CurMap);  
  if ( $Map ne $ResMap ) { next; }  
     }  
     my $meta=$hash{'src_'.$ResId};  
     my $PartNo = 0;  
     undef %TempHash;  
     foreach (split(/\,/,&Apache::lonnet::metadata($meta,'keys'))){  
  if ($_=~/^stores\_(\d+)\_tries$/) {  
                     my $Part=&Apache::lonnet::metadata($meta,$_.'.part');  
     if ( $TempHash{"$Part"} eq '' ) {   
  $TempHash{"$Part"} = $Part;  
  $TempHash{$PartNo}=$Part;  
  $TempHash{"$Part.Code"} = '-';    
  $TempHash{"$Part.PrOrd"} = $PrOrd+$PartNo;    
  $PartNo++;  
     }  
  }  
             }  
   
             my $Prob = $Map.'___'.$2.'___'.  sub PrepareClasslist {
                        &Apache::lonnet::declutter( $hash{'src_'.$ResId} );      my %Sections;
             $Code='U';      &clear_classlist_variables();
             $Tries = 0;      #
             $Wrongs = 0;      # Retrieve the classlist
      $LatestVersion = $result{"version:$Prob"};             my $cid  = $env{'request.course.id'};
       my $cdom = $env{'course.'.$cid.'.domain'};
     if ( $LatestVersion ) {      my $cnum = $env{'course.'.$cid.'.num'};
  for ( my $Version=1; $Version<=$LatestVersion; $Version++ ) {      my ($classlist,$field_names) = &Apache::loncoursedata::get_classlist($cdom,
     my $vkeys = $result{"$Version:keys:$Prob"};   $cnum);
     my @keys = split(/\:/,$vkeys);      my @selected_sections = &get_selected_sections();
         my @selected_groups = &get_selected_groups();
     foreach my $Key (@keys) {        #
  if (($Key=~/\.(\w+)\.solved$/) && ($Key!~/^\d+\:/)) {      # Deal with instructors with restricted section access
     my $Part = $1;      if ($env{'request.course.sec'} !~ /^\s*$/) {
     $Tries = $result{"$Version:$Prob:resource.$Part.tries"};          @selected_sections = ($env{'request.course.sec'});
     $TempHash{"$Part.Tries"} = ($Tries) ? $Tries : 0;       }
     $TotalTries += $Tries;      #
     my $Val = $result{"$Version:$Prob:resource.$Part.solved"};      # Set up %StudentData
     if ( $Val eq 'correct_by_student' )      @StudentDataOrder = qw/fullname username domain id section status groups comments/;
                                 { $Wrongs = $Tries - 1; $Code = 'Y'; }       foreach my $field (@StudentDataOrder) {
     elsif ( $Val eq 'correct_by_override' )          $StudentData{$field}->{'title'} = &mt($field);
                                 { $Wrongs = $Tries - 1; $Code = 'y'; }                                  $StudentData{$field}->{'base_width'} = length(&mt($field));
     elsif ( $Val eq 'incorrect_attempted' ||           $StudentData{$field}->{'width'} = 
                                 $Val eq 'incorrect_by_override' )                                 $StudentData{$field}->{'base_width'};
                 { $Wrongs = $Tries; $Code = 'N'; }      }
     $TempHash{"$Part.Code"} = $Code;      #
     $TempHash{"$Part.Wrongs"} = $Wrongs;      # get the status requested
  }      $enrollment_status = 'Active';
          }      $enrollment_status = $env{'form.Status'} if (exists($env{'form.Status'}));
                 }       #
  for ( my $n = 0; $n < $PartNo; $n++ ) {        # Get groupmembership
     my $part = $TempHash{$n};      my ($classgroups,$studentgroups);
     if ($PtrTry ne '') {$PtrTry .= ',';}      my %curr_groups = &Apache::longroup::coursegroups($cdom,$cnum);
     $PtrTry .= "$TempHash{$part.'.Tries'}";      if (%curr_groups) {
                     $PtrCod .= "$TempHash{$part.'.Code'}";              ($classgroups,$studentgroups) = 
  }      &Apache::loncoursedata::get_group_memberships($classlist,
                                                             $field_names,
     $cdom,$cnum);
       }
       my $now = time;
   
       # 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; 
               }
           }
           my @studentsgroups = &Apache::loncoursedata::get_students_groups
                                                      ($student,$enrollment_status,
                                                       $classgroups);
           if (@studentsgroups) {
               $studenthash->{'groups'} = join(', ',@studentsgroups);
               $studenthash->{'groupref'} = \@studentsgroups;
           } else {
               $studenthash->{'groups'} = 'none';
               $studenthash->{'groupref'} = []; 
           }
           push (@FullClasslist,$studenthash);
           #
           # 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 (@selected_sections) {
               if ( (($sect eq 'all') || 
                     ($section eq $sect)) &&
                    (($studenthash->{'status'} eq $enrollment_status) || 
                     ($enrollment_status eq 'Any')) 
                    ){
                   my $groupcheck = 0;
                   if (grep(/^all$/,@selected_groups)) {
                       push(@Students,$studenthash);
                       last;
                   } elsif (grep(/^none$/,@selected_groups)) {
                       if ($studenthash->{'groups'} eq 'none') {
                           push(@Students,$studenthash);
                           last;
                       }     
                   } else {
                       foreach my $group (@selected_groups) {
                           if (grep(/^$group$/,@studentsgroups)) {
                               push(@Students,$studenthash);
                               $groupcheck = 1;
                               last;
                           }
                       }
                       if ($groupcheck) {
                           last;
                       }
                   }
             }              }
     else {   
  for(my $n=0; $n<$PartNo; $n++) {   
     if ($PtrTry ne '') {$PtrTry .= ',';}  
     $PtrTry .= "0";  
                     $PtrCod .= "-";   
  }  
     }  
         }          }
     }      }
     $Str .= "\n".'</table>';      #
     $r->print($Str);      # Put the consolidated section data in the right place
     $r->rflush();      if ($env{'request.course.sec'} !~ /^\s*$/) {
 }          @Sections = ($env{'request.course.sec'});
       } else {
 sub CreateTable {          @Sections = sort {
     my ($Hd, $Hid)=@_;      if ($a == $a && $b == $b ) { return $a <=> $b; }
     if ( $Hd == 1 ) {      return $a cmp $b;
 # $Hid=~/(\d+)\.(\d+)/;   } keys(%Sections);
  $r->print('<br><a href="'.$hash{'src_'.$Hid}.  
                   '" target="_blank">'.$hash{'title_'.$Hid}.'</a>'          unshift(@Sections,'all'); # Put 'all' at the front of the list
 #                  .' ('.&Apache::lonnet::declutter($hash{'map_id_'.$1}).')'      }
                  );      # Sort the groups
     }      @Groups = sort {$a cmp $b} keys(%{$studentgroups});
     my $Result = "\n".'<table border=2>';      unshift(@Groups,'all'); # Put 'all' at the front of the list
     $Result .= '<tr><th>P#</th>'."\n";  
     for ( my $nIdx=0; $nIdx < 11; $nIdx++ ) {       #
  $Result .= '<th>'.'<input type="submit" name="sort" value="'.      # Sort the Students
                    $Header{$nIdx}.'" />'.'</th>'."\n";      my $sortby = 'fullname';
       $sortby = $env{'form.sort'} if (exists($env{'form.sort'}));
       my @TmpStudents = sort { lc($a->{$sortby}) cmp lc($b->{$sortby}) ||
                                lc($a->{'fullname'}) cmp lc($b->{'fullname'}) ||
        lc($a->{'username'}) cmp lc($b->{'username'}) } @Students;
       @Students = @TmpStudents;
       # 
       # Now deal with that current student thing....
       $curr_student = undef;
       if (exists($env{'form.SelectedStudent'})) {
           my ($current_uname,$current_dom) = 
               split(':',$env{'form.SelectedStudent'});
           my $i;
           for ($i = 0; $i<=$#Students; $i++) {
               next if (($Students[$i]->{'username'} ne $current_uname) || 
                        ($Students[$i]->{'domain'}   ne $current_dom));
               $curr_student = $Students[$i];
               last; # If we get here, we have our student.
           }
           if (defined($curr_student)) {
               if ($i == 0) {
                   $prev_student = undef;
               } else {
                   $prev_student = $Students[$i-1];
               }
               if ($i == $#Students) {
                   $next_student = undef;
               } else {
                   $next_student = $Students[$i+1];
               }
           }
     }      }
     $Result .= "\n".'</tr>'."\n";          #
     $r->print( $Result );      if (exists($env{'form.StudentData'})) {
     $r->rflush();   @SelectedStudentData = 
 }      &Apache::loncommon::get_env_multiple('form.StudentData');
       } else {
 sub CloseTable {          @SelectedStudentData = ('username');
     $r->print("\n".'</table>'."\n");      }
     $r->rflush();      foreach (@SelectedStudentData) {
 }          if ($_ eq 'all') {
                @SelectedStudentData = ('all');
 # ------------------------------------------- Prepare Statistics Table              last;
 sub PreStatTable {  
     my $CacheDB = "/home/httpd/perl/tmp/$ENV{'user.name'}".  
                   "_$ENV{'user.domain'}_$cid\_statistics.db";  
     my $GraphDB = "/home/httpd/perl/tmp/$ENV{'user.name'}".  
                   "_$ENV{'user.domain'}_$cid\_graph.db";  
     my $CachDisFac = "/home/httpd/perl/tmp/$ENV{'user.name'}".  
      "_$ENV{'user.domain'}_$cid\_DiscFactor.db";  
     $r->print('<br><input type="submit" name="sort" value="Recalculate Statistics" />');  
   
     my $Ptr = '';  
   
     $Ptr .= '<br><b> Sorting Type: &nbsp; </b>'."\n".  
             '<select name="order"> <option '.$OpSel1.' >Ascending</option>'."\n".  
     '<option '.$OpSel2.'>Descending</option> </select> '."\n";  
     $Ptr .= '&nbsp;&nbsp;&nbsp;';  
     $Ptr .= '<input type="submit" name="sort" value="DoDiff Graph" />'."\n";  
     $Ptr .= '&nbsp;&nbsp;&nbsp;';  
     $Ptr .= '<input type="submit" name="sort" value="%Wrong Graph" />'."\n";  
   
     $Ptr .= '<pre>'.  
     '  #Stdnts: Total Number of Students opened the problem.<br>'.   
     '  Tries  : Total Number of Tries for solving the problem.<br>'.   
     '  Mod    : Maximunm Number of Tries for solving the problem.<br>'.   
     '  Mean   : Average Number of the tries. [ Tries / #Stdnts ]<br>'.  
     '  #YES   : Number of students solved the problem correctly.<br>'.   
     '  #yes   : Number of students solved the problem by override.<br>'.  
     '  %Wrng  : Percentage of students tried to solve the problem but'.  
     ' still incorrect. [ 100*((#Stdnts-(#YES+#yes))/#Stdnts) ]<br>'.  
 #    '  DoDiff : Degree of Difficulty of the problem. [ Tries/(#YES+#yes+0.1) ]<br>'.  
     '  DoDiff : Degree of Difficulty of the problem. [ 1 - ((#YES+#yes) / Tries) ]<br>'.  
     '  S.D.   : Standard Deviation of the tries.'.  
     '[ sqrt(sum((Xi - Mean)^2)) / (#Stdnts-1)'.  
     ' where Xi denotes every student\'s tries ]<br>'.  
     '  Skew.  : Skewness of the students tries.'.  
     ' [ (sqrt( sum((Xi - Mean)^3) / #Stdnts)) / (S.D.^3) ]<br>'.  
   
 #    '  Dis.F. : Discrimination Factor. [ Sum of Partial Credits Awarded / Total Number of Tries in %27 upper and lower students]</b>'.  
             '</pre>';  
   
     $r->print($Ptr);  
     $r->rflush();  
   
     if ((-e "$CacheDB")&&($ENV{'form.sort'} ne 'Recalculate Statistics')) {  
  if (tie(%CachData,'GDBM_File',"$CacheDB",&GDBM_READER,0640)) {  
     tie(%GraphDat,'GDBM_File',$GraphDB,&GDBM_WRCREAT,0640);  
     &Cache_Statistics();  
         }  
         else {  
     $r->print("Unable to tie hash to db file");  
         }  
     }  
     else {  
  if (tie(%CachData,'GDBM_File',$CacheDB,&GDBM_WRCREAT,0640)) {  
     tie(%DiscFac,'GDBM_File',$CachDisFac,&GDBM_WRCREAT,0640);  
     tie(%GraphDat,'GDBM_File',$GraphDB,&GDBM_WRCREAT,0640);  
     foreach (keys %DiscFac) {delete $CachData{$_};}  
     foreach (keys %CachData) {delete $CachData{$_};}  
     $DiscFlag=0;  
     &Build_Statistics();  
  }  
         else {  
     $r->print("Unable to tie hash to db file");  
         }          }
     }      }
     #$r->print('Total instances of the problems : '.($p_count*($#students+1)));      #
       return;
     untie(%CachData);  
     untie(%GraphDat);  
     untie(%DiscFac);         
 }  }
   
   
 # ------------------------------------- Find the section of student in a course  sub get_selected_sections {
       my @selected_sections = 
 sub usection {   &Apache::loncommon::get_env_multiple('form.Section');
     my ($udom,$unam,$courseid)=@_;      @selected_sections = ('all') if (! @selected_sections);
     $courseid=~s/\_/\//g;      foreach (@selected_sections) {
     $courseid=~s/^(\w)/\/$1/;          if ($_ eq 'all') {
     map {              @selected_sections = ('all');
         my ($key,$value)=split(/\=/,$_);          }
         $key=&Apache::lonnet::unescape($key);      }
         if ($key=~/^$courseid(?:\/)*(\w+)*\_st$/) {      #
             my $section=$1;      # Deal with instructors with restricted section access
             if ($key eq $courseid.'_st') { $section=''; }      if ($env{'request.course.sec'} !~ /^\s*$/) {
     my ($dummy,$end,$start)=split(/\_/,&Apache::lonnet::unescape($value));          @selected_sections = ($env{'request.course.sec'});
             $section=($section) ? $section : '(none)';      }
 #            $section=(int($section)) ? int($section) : $section;      return @selected_sections;
 #            $r->print($unam.'...'.$section.'<br>');  
     return $section;  
         }  
     } split(/\&/,&Apache::lonnet::reply('dump:'.$udom.':'.$unam.':roles',  
                         &Apache::lonnet::homeserver($unam,$udom)));  
     return '';  
 }  }
   
   
 # ------ Dump the Student's DB file and handling the data for statistics table   sub get_selected_groups {
       my @selected_groups =
           &Apache::loncommon::get_env_multiple('form.Group');
       @selected_groups = ('all') if (! @selected_groups);
       foreach my $grp (@selected_groups) {
           if ($grp eq 'all') {
               @selected_groups = ('all');
               last;
           }
       }
       return @selected_groups;
   }
                                                                                       
   
 sub ExtractStudentData {  
     my ($student,$coid)=@_;  
     my ($sname,$sdom) = split( /\:/, $student );  
     my $shome=&Apache::lonnet::homeserver( $sname,$sdom );            
     my $reply=&Apache::lonnet::reply('dump:'.$sdom.':'.$sname.':'.$coid,$shome );  
     my %result = ();  
     my $ResId;  
     my $PrOrd;  
     my $Dis = '';  
     my $Code;  
     my $Tries;  
     my $ParCr;  
     my $TotalTries = 0;  
     my $TotalOpend = 0;  
     my $ProbSolved = 0;  
     my $ProbTot = 0;  
     my $TimeTot = 0;  
     my $TotParCr = 0;  
     my $Wrongs;  
     my %TempHash;  
     my $Version;  
     my $LatestVersion;  
     my $SecLimit;  
     my $MapLimit;  
     unless ($reply=~/^error\:/) {  
         foreach (split(/\&/,$reply)) {  
             my ($name,$value)=split(/\=/,&Apache::lonnet::unescape($_));  
             $result{$name}=$value;  
         }  
         foreach my $CurCol(@cols) {  
     ($PrOrd,$ResId)=split(/\:/,$CurCol);  
     if ( !$CurCol ) { next; }  
             $ResId=~/(\d+)\.(\d+)/;  
     my $MapId=$1;  
     my $PrbId=$2;  
             my $Map = &Apache::lonnet::declutter( $hash{'map_id_'.$MapId} );  
             if ( $CurMap ne 'All Maps' ) {  
  my ( $ResMap, $NameMap ) = split(/\=/,$CurMap);  
  if ( $Map ne $ResMap ) { next; }  
     }  
     my $meta=$hash{'src_'.$ResId};  
     my $PartNo = 0;  
     $Dis .= ':';  
     undef %TempHash;  
     foreach (split(/\,/,&Apache::lonnet::metadata($meta,'keys'))) {  
  if ($_=~/^stores\_(\d+)\_tries$/) {  
                     my $Part=&Apache::lonnet::metadata($meta,$_.'.part');  
     if ( $TempHash{"$Part"} eq '' ) {   
  $TempHash{"$Part"} = $Part;  
  $TempHash{$PartNo}=$Part;  
  $TempHash{"$Part.Code"} = 'U';    
  $TempHash{"$Part.PrOrd"} = $PrOrd+$PartNo;  
  $PartNo++;  
     }  
  }  
             }  
   
             my $Prob = $Map.'___'.$PrbId.'___'.  sub section_and_enrollment_description {
                        &Apache::lonnet::declutter( $hash{'src_'.$ResId} );      my ($mode) = @_;
             $Code='U';      if (! defined($mode)) { $mode = 'localized'; }
             $Tries = 0;      my @sections = &Apache::lonstatistics::get_selected_sections();
     $ParCr = 0;      my @groups = &Apache::lonstatistics::get_selected_groups();
             $Wrongs = 0;      my $description;
      $LatestVersion = $result{"version:$Prob"};             if ($mode eq 'localized') {
           $description = &mt('Unable to determine section, groups and access status');
     if ( $LatestVersion ) {      } elsif ($mode eq 'plaintext') {
  for ( my $Version=1; $Version<=$LatestVersion; $Version++ ) {          $description = 'Unable to determine section, groups and access status';
     my $vkeys = $result{"$Version:keys:$Prob"};      } else {
     my @keys = split(/\:/,$vkeys);          $description = 'Bad parameter passed to lonstatistics::section_and_enrollment_description';
             &Apache::lonnet::logthis($description);
     foreach my $Key (@keys) {        }
  if (($Key=~/\.(\w+)\.solved$/) && ($Key!~/^\d+\:/)) {      $description = &section_or_group_text($mode,'section',@sections).
     my $Part = $1;   ' '.&section_or_group_text($mode,'group',@groups);
     $Tries = $result{"$Version:$Prob:resource.$Part.tries"};      if ($mode eq 'localized') {
     $ParCr = $result{"$Version:$Prob:resource.$Part.awarded"};          $description .= ' '.&mt($env{'form.Status'}.' access status.');
     my $Time = $result{"$Version:$Prob:timestamp"};      } elsif ($mode eq 'plaintext') {
     $TempHash{"$Part.Time"} = ($Time) ? $Time : 0;          $description .= ' '.$env{'form.Status'}.' access status.';
     $TempHash{"$Part.Tries"} = ($Tries) ? $Tries : 0;  
     $TempHash{"$Part.ParCr"} = ($ParCr) ? $ParCr : 0;          
     $TotalTries += $TempHash{"$Part.Tries"};  
     $TotParCr += $TempHash{"$Part.ParCr"};  
 #$r->print($Version.'---'.$Prob.'==='.$Time.'<br>');  
     my $Val = $result{"$Version:$Prob:resource.$Part.solved"};  
     if ( $Val eq 'correct_by_student' )  
                                { $Wrongs = $Tries - 1; $Code = 'C'; }   
     elsif ( $Val eq 'correct_by_override' )  
                                { $Wrongs = $Tries - 1; $Code = 'O'; }                          
     elsif ( $Val eq 'incorrect_attempted' ||   
                                 $Val eq 'incorrect_by_override' )  
                { $Wrongs = $Tries; $Code = 'I'; }  
     $TempHash{"$Part.Code"} = $Code;  
     $TempHash{"$Part.Wrongs"} = $Wrongs;  
  }  
          }  
                 }   
  for ( my $n = 0; $n < $PartNo; $n++ ) {    
     my $part = $TempHash{$n};  
     my $Yes = 0;  
                     if ( $TempHash{$part.'.Code'} eq 'C' ||  
                          $TempHash{$part.'.Code'} eq 'O'  )   
        {$ProbSolved++;$Yes=1;}      
 #    my $ptr = "$hash{'title_'.$ResId}";  
     my $ptr = $TempHash{$part.'.PrOrd'}.':'.$ResId;  
     if ( $PartNo > 1 ) {                  
  $ptr .= "*(part $part)";  
  $Dis .= ':';  
     }  
     my $Fac = ($TempHash{"$part.Tries"}) ?   
                               ($TempHash{"$part.ParCr"}/$TempHash{"$part.Tries"}) : 0;  
     my $DisF;  
     if ( $Fac > 0 &&  $Fac < 1 ) {   
  $DisF = sprintf( "%.4f", $Fac );  
     }  
     else {$DisF = $Fac;}  
 #    $DisF .= '+'.$TempHash{"$part.Time"};  
     $TimeTot += $TempHash{"$part.Time"};  
     $Dis .= $ptr.'*'.$ResId.'='.$DisF.'+'.$Yes;  
     $ptr .= ":$TempHash{$part.'.Tries'}".  
             ":$TempHash{$part.'.Wrongs'}".  
                             ":$TempHash{$part.'.Code'}";  
     push (@list, $ptr);  
     $TotalOpend++;  
     $ProbTot++;  
  }  
             }  
     #else {   
  #for(my $n=0; $n<$PartNo; $n++) {  
  #    push (@list, "$hash{'title_'.$ResId}*$ResId:0:0:U");  
  #    $ProbTot++;   
  #}  
     #}  
         }  
  if ( $TotalTries ) {  
     my $DisFac = ( $TotalTries ) ? ($TotParCr/$TotalTries) : 0;  
 #    my $DisFactor = int(sprintf( "%.4f", $DisFac ) * 100);  
     my $DisFactor = sprintf( "%.4f", $DisFac );  
     my $time;  
     if ($ProbSolved){  
  $time = int(($TimeTot/$ProbSolved)-10000000);  
     }  
     $DiscFac{($DisFactor.':'.$sname.':'.$ProbTot.':'.$TotalOpend.':'.  
                       $TotalTries.':'.$ProbSolved.':'.$time)}=$Dis;  
 #$r->print($DisFactor.$sname.'<br> --- Dis= '.$Dis.'<br>');  
  }  
     }      }
     #$r->print($sname.' PrCr= '.$TotParCr.' Slvd= '.$ProbSolved.' Tries='.$TotalTries.'<br>');      return $description;
 }  }
   
   
 # ------------------------------------------------------------ Build page table  
 sub tracetable {  
     my ($rid,$beenhere)=@_;  
     $rid=~/(\d+)\.(\d+)/;  
     $maps{&Apache::lonnet::declutter($hash{'map_id_'.$1})}='';#$hash{'title_'.$rid};   
     #$maps{$HWN}=$hash{'title_'.$rid};   
     unless ($beenhere=~/\&$rid\&/) {  
        $beenhere.=$rid.'&';   
        if (defined($hash{'is_map_'.$rid})) {  
    my $cmap=$hash{'map_type_'.$hash{'map_pc_'.$hash{'src_'.$rid}}};  
            if ( $cmap eq 'sequence' || $cmap eq 'page' ) {   
                $cols[$#cols+1]=0;  
        $P_Order++;  
        $HWN=$P_Order;  
                $mapsort{$HWN} = $rid.':';   
                #$maps{&Apache::lonnet::declutter($hash{'src_'.$rid})}=   
                #      $hash{'title_'.$rid};   
            }  
            if ((defined($hash{'map_start_'.$hash{'src_'.$rid}})) &&  
                (defined($hash{'map_finish_'.$hash{'src_'.$rid}}))) {  
        my $frid=$hash{'map_finish_'.$hash{'src_'.$rid}};  
   
                &tracetable($hash{'map_start_'.$hash{'src_'.$rid}},  
    '&'.$frid.'&');  
   
        $cols[$#cols+1]=($P_Order+1).':'.$frid;  sub section_or_group_text {
             my ($mode,$type,@items) = @_;
        my $meta=$hash{'src_'.$frid};      my $text;
        my $PartNo = 0;      my %phrases = ();
                if ($meta) {      %{$phrases{'section'}} = (
    if ($meta=~/\.(problem|exam|quiz|assess|survey|form)$/) {                                single => 'Section',
        foreach (split(/\,/,&Apache::lonnet::metadata($meta,'keys'))) {                                all => 'All sections',
    if ($_=~/^stores\_(\d+)\_tries$/) {                                plural => 'Sections',
        &Apache::lonnet::metadata($meta,$_.'.part');                               );
        $P_Order++;      %{$phrases{'group'}} = (
        $mapsort{$HWN} .= '&'.$P_Order;                                single => 'Group',
        $PartNo++;                                all => 'All groups',
        $r->print('<br>'.$PartNo.'---'.$P_Order);                                plural => 'Groups',
    }                               );
        }      if (scalar(@items) == 1 && $items[0] ne 'all') {
    }          if ($mode eq 'localized') {
                }              $text = &mt($phrases{$type}{single}.' [_1].',$items[0]);
    }          } elsif ($mode eq 'plaintext') {
        } else {              $text = $phrases{$type}{single}.' '.$items[0].'.';
    $cols[$#cols+1]=($P_Order+1).':'.$rid;  
    my $meta=$hash{'src_'.$rid};  
    my $PartNo = 0;  
            if ($meta) {  
        if ($meta=~/\.(problem|exam|quiz|assess|survey|form)$/) {  
    foreach (split(/\,/,&Apache::lonnet::metadata($meta,'keys'))) {  
        if ($_=~/^stores\_(\d+)\_tries$/) {  
    &Apache::lonnet::metadata($meta,$_.'.part');  
    $P_Order++;  
    $mapsort{$HWN} .= '&'.$P_Order;  
    $PartNo++;  
        }  
    }  
        }  
    }  
        }  
        if (defined($hash{'to_'.$rid})) {  
           foreach (split(/\,/,$hash{'to_'.$rid})){  
               &tracetable($hash{'goesto_'.$_},$beenhere);  
           }  
        }  
     }  
 }  
   
 sub MySort {                    }
     if ( $Pos > 0 && $Pos < 11 ) {      } elsif (scalar(@items) && $items[0] eq 'all') {
  if ($ENV{'form.order'} eq 'Descending') {$b <=> $a;}          if ($mode eq 'localized') {
  else { $a <=> $b; }              $text = &mt($phrases{$type}{all}.'.');
     }          } elsif ($mode eq 'plaintext') {
     else {              $text = $phrases{$type}{all}.'.';
  if ($ENV{'form.order'} eq 'Descending') {$b cmp $a;}          }
  else { $a cmp $b; }      } elsif (scalar(@items)) {
           my $lastitem = pop(@items);
           if ($mode eq 'localized') {
               $text = &mt($phrases{$type}{plural}.' [_1] and [_2].',
                           join(', ',@items),$lastitem);
           } elsif ($mode eq 'plaintext') {
               $text = $phrases{$type}{plural}.' '.join(', ',@items).' and '.
                       $lastitem.'.';
           }
     }      }
       return $text;
 }  }
   
 sub Build_Statistics {  
     $r->print(<<ENDPOP);  
     <script>  
     popwin=open('','popwin','width=400,height=100');  
     popwin.document.writeln('<html><body bgcolor="#7777EE">'+  
       '<title>LON-CAPA Statistics</title>'+  
       '<h4>Computation Progress</h4>'+  
       '<form name=popremain>'+  
       '<input type=text size=35 name=remaining value=Starting></form>'+  
       '</body></html>');  
     popwin.document.close();  
     </script>  
 ENDPOP  
   
     $r->rflush();  sub get_students {
 # ---------------------------- Gathering the Data of students' tries      if (! @Students) {
     my $index;          &PrepareClasslist()
     for ($index=0;$index<=$#students;$index++) {  
 #----------- update progress  
         $r->print('<script>popwin.document.popremain.remaining.value="'.  
                   'Computing '.($index+1).'/'.($#students+1).': '.  
                   $students[$index].'";</script>');  
         $r->rflush();  
   
         &ExtractStudentData($students[$index],$cid);  
     }      }
 #--------------------- close Progress Line      return @Students;
     $r->print('<script>popwin.close()</script>');  }
     $r->rflush();   
 # -------------------- sorting the Data  
     @list = sort (@list);  
   
     $OpSel2='';  
     $OpSel1='selected';  
       
     $p_count = 0;   
     my $nIdx = 0;  
     my $dummy;   
     my $p_val;  
     my $ResId;  
     my $NoElements = $#list + 1;  
 #-------------------------------- loop for data representation  
     foreach (sort keys %mapsort) {  
  my ($Hid,$pr)=split(/\:/,$mapsort{$_});  
  my @lpr=split(/\&/,$pr);  
  &CreateTable(1,$Hid);  
  for (my $i=1; $i<=$#lpr; $i++) {  
     my %storestats=();  
     my ($PrOrd,$Prob,$Tries,$Wrongs,$Code)=split(/\:/,$list[$nIdx]);  
     my $Temp = $Prob;  
     my $MxTries = 0;  
     my $TotalTries = 0;  
     my $YES = 0;  
     my $Incorrect = 0;  
     my $Override = 0;  
     my $StdNo = 0;  
     my @StdLst;  
     while ( $PrOrd == $lpr[$i] )   
     {  
  $nIdx++;  
  $StdNo++;  
  $StdLst[ $StdNo ] = $Tries;  
  $TotalTries += $Tries;  
  if ( $MxTries < $Tries ) { $MxTries = $Tries; }   
  if ( $Code eq 'C' ){ $YES++; }  
  elsif( $Code eq 'I' ) { $Incorrect++; }  
  elsif( $Code eq 'O' ) { $Override++; }  
  elsif( $Code eq 'U' ) { $StdNo--; }  
  ($PrOrd,$Prob,$Tries,$Wrongs,$Code)=split(/\:/,$list[$nIdx]);  
     }  
   
     $p_count++;  
     my $Dummy;  
     ($ResId,$Dummy)=split(/\*/,$Temp);  
   
     $Temp = '<a href="'.$hash{'src_'.$ResId}.  
                 '" target="_blank">'.$hash{'title_'.$ResId}.$Dummy.'</a>';  
       
     my $res = &Apache::lonnet::declutter($hash{'src_'.$ResId});  
     my $urlres=$res;  
   
     $ResId=~/(\d+)\.(\d+)/;  
     my $Map = &Apache::lonnet::declutter( $hash{'map_id_'.$1} );  
     $urlres=$Map;  
    
     $res = '<a href="'.$hash{'src_'.$ResId}.'">'.$res.'</a>';  
     #$Map = '<a href="'.$Map.'">'.$res.'</a>';  
   
 #------------------------ Compute the Average of Tries about one problem  sub current_student { 
     my $Average = ($StdNo) ? $TotalTries/$StdNo : 0;      return $curr_student;
   }
   
     $storestats{$ENV{'request.course.id'}.'___'.$urlres.'___timestamp'}=time;         
     $storestats{$ENV{'request.course.id'}.'___'.$urlres.'___stdno'}=$StdNo;  
     $storestats{$ENV{'request.course.id'}.'___'.$urlres.'___avetries'}=$Average;  
      
 #-------------------------------- Compute percentage of Wrong tries  
     my $Wrong = ( $StdNo ) ? 100 * ( $Incorrect / $StdNo ) : 0;  
   
 #-------------------------------- Compute Standard Deviation  
     my $StdDev = 0;   
     if ( $StdNo > 1 ) {  
  for ( my $n = 0; $n < $StdNo; $n++ ) {  
     my $Dif = $StdLst[ $n ]-$Average;  
     $StdDev += $Dif*$Dif;  
  }   
  $StdDev /= ( $StdNo - 1 );  
  $StdDev = sqrt( $StdDev );  
     }  
   
 #-------------------------------- Compute Degree of Difficulty  
     my $DoDiff = 0;  
     if( $TotalTries > 0 ) {  
  $DoDiff = 1 - ( ( $YES + $Override ) / $TotalTries );  
 #    $DoDiff =  ($TotalTries)/($YES + $Override+ 0.1);      
     }  
          
     $storestats{$ENV{'request.course.id'}.'___'.$urlres.'___difficulty'}=$DoDiff;  
   
 #-------------------------------- Compute the Skewness  
     my $Skewness = 0;  
     my $Sum = 0;   
     if ( $StdNo > 0 && $StdDev > 0 ) {  
  for ( my $n = 0; $n < $StdNo; $n++ ) {  
     my $Dif = $StdLst[ $n ]-$Average;  
     $Skewness += $Dif*$Dif*$Dif;  
  }   
  $Skewness /= $StdNo;  
     $Skewness /= $StdDev*$StdDev*$StdDev;  
     }  
 #-----------------  Some restition in presenting the float numbers  
     my $Avg = sprintf( "%.2f", $Average );  
     my $Wrng = sprintf( "%.1f", $Wrong );  
     my $SD = sprintf( "%.1f", $StdDev );  
     my $DoD = sprintf( "%.2f", $DoDiff );  
     my $Sk = sprintf( "%.1f", $Skewness );  
     my $join = $PrOrd.':'.$Temp.':'.$StdNo.':'.  
                        $TotalTries.':'.$MxTries.':'.$Avg.':'.  
                        $YES.':'.$Override.':'.$Wrng.':'.$DoD.':'.  
        $SD.':'.$Sk.':'.$Map.':'.$Prob;  
     $CachData{($p_count-1)}=$join;  
   
     $urlres=~/^(\w+)\/(\w+)/;  
     if ($StdNo) {   
  &Apache::lonnet::put('resevaldata',\%storestats,$1,$2);   
     }  
 #-------------------------------- Row of statistical table  
     if ( $DiscFlag == 0 ) {  
  &TableRow($join,$i,($p_count-1));  
     }   
  }  
  &CloseTable();  
     }  
 }  
   
 sub Cache_Statistics {  sub previous_student { 
     my @list = ();      return $prev_student;
     my $Useful;  
     my $UnUseful;  
     my %myHeader = reverse( %Header );  
     $Pos = $myHeader{$ENV{'form.sort'}};  
     if ($Pos > 0) {$Pos++;}  
     $p_count = 0;  
     foreach my $key( keys %CachData) {   
  my @Temp=split(/\:/,$CachData{$key});  
  if ( $Pos == 0 || $Pos == 11 ) {  
     ($UnUseful,$Useful)=split(/\>/,$Temp[$Pos]);  
  }  
  else {  
     $Useful = $Temp[$Pos];  
  }     
  $list[$p_count]=$Useful.'&'.$CachData{$key};  
         $p_count++;  
     }  
   
     @list = sort MySort (@list);  
   
     my $nIdx=0;  
   
     if ( $Pos == 0 ) {  
  foreach (sort keys %mapsort) {  
     my ($Hid,$pr)=split(/\:/,$mapsort{$_});  
     &CreateTable(1,$Hid);  
     my @lpr=split(/\&/,$pr);  
     for (my $i=1; $i<=$#lpr; $i++) {  
  my($Pre, $Post) = split(/\&/,$list[$nIdx]);   
  &TableRow($Post,$i,$nIdx);  
  $nIdx++;  
     }  
     &CloseTable();  
  }  
     }  
     else {  
  &CreateTable(0);  
  for ( my $nIdx = 0; $nIdx < $p_count; $nIdx++ ) {  
     my($Pre, $Post) = split(/\&/,$list[$nIdx]);   
     &TableRow($Post,$nIdx,$nIdx);  
  }   
  &CloseTable();  
     }  
 }  }
   
 sub TableRow {  
     my ($Str,$Idx,$RealIdx)=@_;  
     my($PrOrd,$Temp,$StdNo,$TotalTries,$MxTries,$Avg,$YES,  sub next_student { 
        $Override,$Wrng,$DoD,$SD,$Sk,$res,$Prob)=split(/\:/,$Str);      return $next_student;
     $r->print( "\n".'<tr>'.  
                "\n".'<td>'.($RealIdx+1).'</td>'.  
                "\n".'<td bgcolor="#FFFFFF">'.$Temp.'</td>'.  
                "\n".'<td bgcolor="#EEFFDD"> '.$StdNo.'</td>'.  
                "\n".'<td bgcolor="#EEFFDD">'.$TotalTries.'</td>'.  
                "\n".'<td bgcolor="#EEFFDD">'.$MxTries.'</td>'.  
                "\n".'<td bgcolor="#DDFFFF">'.$Avg.'</td>'.  
                "\n".'<td bgcolor="#DDFFFF"> '.$YES.'</td>'.  
                "\n".'<td bgcolor="#DDFFFF"> '.$Override.'</td>'.  
                "\n".'<td bgcolor="#FFDDDD"> '.$Wrng.'</td>'.  
                "\n".'<td bgcolor="#FFDDDD">'.$DoD.'</td>'.  
                "\n".'<td bgcolor="#DDFFDD"> '.$SD.'</td>'.  
                "\n".'<td bgcolor="#DDFFDD"> '.$Sk.'</td>'.  
 #               "\n".'<td>'.$res.'</td>'.  
                "\n".'</tr>' );  
     $GraphDat{$RealIdx}=$DoD.':'.$Wrng;  
 }  }
   
 # ------------------------------------------- Prepare data for Graphical chart  
   
 sub GetGraphData {  
     my $Tag = shift;  
     my $Col;  
     my $data='';  
     my $count = 0;  
     my $Max = 0;  
     my $cid=$ENV{'request.course.id'};  
     my $GraphDB = "/home/httpd/perl/tmp/$ENV{'user.name'}".  
                   "_$ENV{'user.domain'}_$cid\_graph.db";  
     foreach (keys %GraphDat) {delete $GraphDat{$_};}  
     if (-e "$GraphDB") {  
  if (tie(%GraphDat,'GDBM_File',"$GraphDB",&GDBM_READER,0640)) {  
     if ( $Tag eq 'DoDiff Graph' ) {  
  $Tag = 'Degree-of-Difficulty';  
  $Col = 0;  
     }  
     else {  
  $Tag = 'Wrong-Percentage';  
  $Col = 1;  
     }  
     foreach (sort NumericSort keys %GraphDat) {   
  my @Temp=split(/\:/,$GraphDat{$_});  
                 my $inf = $Temp[$Col];   
  if ( $Max < $inf ) {$Max = $inf;}  
  $data .= $inf.',';  
  $count++;  
     }  
             untie(%GraphDat);  
     my $Course = $ENV{'course.'.$cid.'.description'};  
     $Course =~ s/\ /"_"/eg;  
     $GData=$Course.'&'.$Tag.'&'.$Max.'&'.$count.'&'.$data;  
   
  }  sub StudentDataSelect {
  else {      my ($elementname,$status,$numvisible)=@_;
     $r->print("Unable to tie hash to db file");      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;
 }  }
   
   
 sub initial {  
 # --------------------------------- Initialize the global varaibles  
   undef @students;  
   undef @cols;  
   undef %maps;  
   undef %section;  
   undef %StuBox;  
   undef @list;  
   undef %CachData;  
   undef %GraphDat;  
   undef %DiscFac;  
   undef $CurMap;  
   undef $CurSec;  
   undef $CurStu;  
   undef $p_count;  
   undef $Pos;  
   undef $GData;  
   $DiscFlag=0;   
   $P_Order=100000;  
   $HWN=$P_Order;  
 }  
   
   sub get_selected_maps {
       my ($elementname) = @_;
       my @selected_maps = 
    &Apache::loncommon::get_env_multiple('form.'.$elementname);
       @selected_maps = ('all') if (! @selected_maps);
       foreach my $map (@selected_maps) {
           if ($map eq 'all') {
               @selected_maps = ('all');
               last;
           }
       }
       return @selected_maps;
   }
   
 sub ClassList {  
   
     &GetStatus();  
   
     $cid=$ENV{'request.course.id'};  
     my $chome=$ENV{'course.'.$cid.'.home'};  
     my ($cdom,$cnum)=split(/\_/,$cid);  
 # ----------------------- Get first and last resource, see if there is anything  
     $firstres=$hash{'map_start_/res/'.$ENV{'request.course.uri'}};  
     $lastres=$hash{'map_finish_/res/'.$ENV{'request.course.uri'}};  
     if (($firstres) && ($lastres)) {  
 # ----------------------------------------------------------------- Render page  
  my $classlst=&Apache::lonnet::reply  
                  ('dump:'.$cdom.':'.$cnum.':classlist',$chome);  
  my $StudNo = 0;  
  unless ($classlst=~/^error\:/) {  
     foreach (sort split(/\&/,$classlst)) {  
  my ($name,$value)=split(/\=/,$_);  
  my ($end,$start)=split(/\:/,&Apache::lonnet::unescape($value));  
  $name=&Apache::lonnet::unescape($name);  
  my ($sname,$sdom)=split(/\:/,$name);  
  my $ssec=&Apache::lonnet::usection($sdom,$sname,$cid);  
                 if ($ssec==-1) {next;}  
  $ssec=($ssec) ? $ssec : '(none)';  
  #$ssec=(int($ssec)) ? int($ssec) : $ssec;  
  #$r->print($sname.'...'.$ssec.'<br>');  
  $section{$ssec}=$ssec;  
  if ($CurSec eq 'All Sections' || $ssec eq $CurSec) {  
     $students[$StudNo]=$name;  
     $StuBox{$sname}=$ssec;  
  }  
  $StudNo++;  
     }  
  }  
  else {  
     $r->print('<h1>Could not access course data</h1>');  
  }   
         $r->print("Total number of students : ".($#students+1));  
         $r->rflush();  
 # --------------- Find all assessments and put them into some linear-like order  
  &tracetable($firstres,'&'.$lastres.'&');  
   
 #    my $c=0;  
 #    foreach (sort keys %mapsort) {  
 # $r->print('<br>'.$c.')'.$_.' ... '.$mapsort{$_});  
 # $c++;  
 #    }  
 #foreach(@cols) {  
 #    $c++;  
 #    $r->print('<br>'.$cols[$c]);  
 #}  
 #$r->print('<br> Count = '.$c);  
   
   sub selected_sequences_with_assessments {
       my ($mode) = @_;
       $mode = 'selected' if (! defined($mode));
       my $navmap = Apache::lonnavmaps::navmap->new();
       if (!defined($navmap)) {
           return ('Can not open Coursemap');
       }
       #
       my @sequences = $navmap->retrieveResources(undef,
                                                  sub { shift->is_map(); },1,0,1);
       my $toplevelseq = $navmap->getById('0.0');
       if (!grep(/^\Q$toplevelseq\E$/,@sequences)) {
           unshift(@sequences,$toplevelseq);
       }
   
       my @sequences_with_assessments;
       foreach my $sequence (@sequences) {
    if ($navmap->hasResource($sequence,sub { shift->is_problem(); },0,1)){
               push(@sequences_with_assessments,$sequence);
           }
     }      }
       #
       my @sequences_to_show;
       foreach my $sequence (@sequences_with_assessments) {
           if ($mode eq 'all') {
               push (@sequences_to_show,$sequence);
           } elsif ($mode eq 'selected') {
               foreach my $map_symb (&get_selected_maps('Maps')) {
                   if ($sequence->symb eq $map_symb || $map_symb eq 'all'){
                       push (@sequences_to_show,$sequence);
                       last; # Only put it in once
                   }
               }
           }
   
 # ------------------------------------------------------------- End render page   
     else {  
  $r->print('<h3>Undefined course sequence</h3>');  
     }      }
     &MapSecOptions();      return $navmap,@sequences_to_show;
 }  }
   
   
 sub Menu {  sub map_select {
     my $InpStr = $ENV{'form.sort'};      my ($elementname,$status,$numvisible)=@_;
     if ( $InpStr eq 'DoDiff Graph' || $InpStr eq '%Wrong Graph' ) {            if ($numvisible < 1) {
  &GetGraphData($InpStr);          return;
     $r->print('<IMG src="/cgi-bin/graph.gif?'.$GData.'" />');      }
     }      #
     else {      # Set up array of selected items
  $r->print('<html><head><title>LON-CAPA Statistics</title></head>');      my @selected_maps = &get_selected_maps($elementname);
       #
       # Build the form element
         $r->print('<body bgcolor="#FFFFFF">'.      my $form = "\n";
                   '<script>window.focus(); window.width=500;window.height=500; </script>'.      $form .= '<select name="'.$elementname.'" ';
                   '<img align=right src=/adm/lonIcons/lonlogos.gif>');      if ($status ne 'single') {
 # ---------------------------------------------------------------- Course title          $form .= 'multiple="true" ';
         $r->print('<h1> Course : "'.      }
                   $ENV{'course.'.$ENV{'request.course.id'}.      $form .= 'size="'.$numvisible.'" >'."\n";
                   '.description'}.'"</h1><h2>'.localtime().'</h2>');      #
 # ------------------------------- This is going to take a while, produce output      # Put in option for 'all'
         $r->rflush();      $form .= '    <option value="all" ';
       if ($selected_maps[0] eq 'all') {
  $r->print("\n".'<form name=stat method=post action="/adm/statistics" >');          $form .= 'selected ';
       }
  my $content = $ENV{'form.sort'};      $form .= ">all</option>\n";
  if ($content eq '' || $content eq 'Return to Menu') {      #
     my $Ptr = '<h3>';      # Loop through the sequences
     $Ptr .= '<input type=submit name=sort value="Problem Evaluation"/>';#General Statistics"/>';      my @sequences = &selected_sequences_with_assessments('all');
     $Ptr .= '<br><br>';      my $navmap;
     $Ptr .= '<input type=submit name=sort value="Student Assessment"/>';      if (!ref($sequences[0])) {
     $Ptr .= '<br><br>';          return $sequences[0];
 #    $Ptr .= '<input type=submit name=sort value=Discrimination>';#"Problem Evaluation"/>';      } else {
     $Ptr .= '</h3>';          $navmap = shift(@sequences);
     $r->print( $Ptr );      }
       }      foreach my $seq (@sequences){
  else {          $form .= '    <option value="'.$seq->symb.'" ';
     &initial();          foreach (@selected_maps) {
     &ClassList();              if ($seq->symb eq $_) {
     if ( $content eq 'Discrimination' || #'Problem Evaluation' ||                  $form .= 'selected ';
                  $content eq 'Recalculate Discrimintion Factor' ) {                  last;
  &CreateDiscFac();              }
     }          }
     elsif ( $content eq 'Student Assessment' ||           $form .= '>'.$seq->compTitle."</option>\n";
                     $content eq 'Create Student Report' ) {  
  &StudentOptions();  
  &StudentReport($CurStu,$StuBox{"$CurStu"});  
     }  
     else {  
  &PreStatTable();  
     }  
  }  
  $r->print("\n".'</form>'.  
                   "\n".'</body>'.  
                   "\n".'</html>');  
  $r->rflush();  
     }      }
       $form .= "</select>\n";
       return $form;
 }  }
   
 sub StudentOptions {  
     my $OpSel5='';  sub SectionSelect {
     $CurStu = $ENV{'form.student'};      my ($elementname,$status,$numvisible)=@_;
     if ( $CurStu eq '' ) {       if ($numvisible < 1) {
         $CurStu = 'All Students';          return;
         $OpSel5 = 'selected';      }
     }      #
     my $Ptr ='';      # Make sure we have the data we need to continue
 # ----------------------------------- Loading the Students Combobox      if (! @Sections) {
     $Ptr .= '<br><b>Select Student</b>'."\n".          &PrepareClasslist()
            '<select name="student">'."\n".       }
     '<option '.$OpSel5.'>All Students</option>';                                   #
     foreach my $key ( sort keys %StuBox ) {                # Build the form element
  $Ptr .= '<option';      my $Str = "\n";
  if ($CurStu eq $key) {$Ptr .= ' selected';}           $Str .= '<select name="'.$elementname.'" ';
         $Ptr .= '>'.$key."</option>\n";           if ($status ne 'single') {
     }          $Str .= 'multiple="true" ';
     $Ptr .= '</select>';      }
     $Ptr .= '<br><input type="submit" name="sort" value="Create Student Report" />';      $Str .= 'size="'.$numvisible.'" >'."\n";
     $r->print( $Ptr );      #
     $r->rflush();      # Loop through the sequences
       foreach my $s (@Sections) {
           $Str .= '    <option value="'.$s.'" ';
           foreach (&get_selected_sections()) {
               if ($s eq $_) {
                   $Str .= 'selected ';
                   last;
               }
           }
           $Str .= '>'.$s."</option>\n";
       }
       $Str .= "</select>\n";
       return $Str;
 }  }
   
 sub GetStatus {  
   
     $OpSelDis1='';  sub GroupSelect {
     $OpSelDis2='';      my ($elementname,$status,$numvisible)=@_;
     $OpSel1='';      if ($numvisible < 1) {
     $OpSel2='';          return;
     $OpSel3='';      }
     $OpSel4='';      #
       # Make sure we have the data we need to continue
 #    if ( $ENV{'form.DisType'} eq 'Total Number of Correct Answers' ) {       if (! @Groups) {
 # $OpSelDis1='selected';           &PrepareClasslist();
 # $CurDis=0;      }
 #    }      #
 #    else { $OpSel2 = 'selected'; $CurDis = 1;}      # Build the form element
       my $Str = "\n";
     if ( $ENV{'form.order'} eq 'Descending' ) { $OpSel2='selected'; }      $Str .= '<select name="'.$elementname.'" ';
     else { $OpSel1 = 'selected'; }      if ($status ne 'single') {
           $Str .= 'multiple="true" ';
     my %myHeader = reverse( %Header );      }
     $Pos = $myHeader{$ENV{'form.sort'}};      $Str .= 'size="'.$numvisible.'" >'."\n";
     if ($Pos == 0) {      #
  $OpSel1 = 'selected';      # Loop through the groups
  $ENV{'form.order'}='Ascendig';      foreach my $s (@Groups) {
     }          $Str .= '    <option value="'.$s.'" ';
           foreach my $group (&get_selected_groups()) {
     $CurMap = $ENV{'form.maps'};              if ($s eq $group) {
     if ( $CurMap eq '' ) {                   $Str .= 'selected ';
  $CurMap = 'All Maps';                  last;
  $OpSel3 = 'selected';              }
     }          }
     $CurSec = $ENV{'form.section'};          $Str .= '>'.$s."</option>\n";
     if ( $CurSec eq '' ) {   
  $CurSec = 'All Sections';  
         $OpSel4 = 'selected';  
     }      }
       $Str .= "</select>\n";
 }  }
   
   
 sub MapSecOptions {  
 # ----------------------------------- Loading the Maps Combobox  
     my $Ptr = '<br>';  sub DisplayClasslist {
     $Ptr .= '<br><input type="submit" name="sort" value="Return to Menu" />';      my ($r)=@_;
     $Ptr .= '<br><b> Select &nbsp; Map &nbsp; &nbsp; </b>'."\n".      &Apache::lonhtmlcommon::add_breadcrumb
            '<select name="maps">'."\n".           ({text=>'Select One Student'});
     '<option '.$OpSel3.'>All Maps</option>';                                   #
     foreach my $key ( sort keys %maps ) {                # Output some of the standard interface components
  $Ptr .= '<option';      my $Str;
         if ($CurMap eq $key) {$Ptr .= ' selected';}           $Str .= &Apache::lonhtmlcommon::breadcrumbs('Select One Student');
  $Ptr .= '>'.$key."</option>\n";           $Str .= '<p><table cellspacing="5">'."\n";
     }      $Str .= '<tr>';
     $Ptr .= '</select>';      $Str .= '<th align="center"><b>'.&mt('Sections').'</b></th>';
     $Ptr .= '&nbsp;&nbsp;&nbsp;';      $Str .= '<th align="center"><b>'.&mt('Groups').'</b></th>';
       $Str .= '<th align="center"><b>'.&mt('Access Status').'</b></th>';
 # ----------------------------------- Loading the Sections Combobox      $Str .= '</tr>'.$/;
     $Ptr .= '<br><b>Select Section</b>'."\n".      $Str .= '<tr>';
            '<select name="section">'."\n".       $Str .= '<td>'.
     '<option '.$OpSel4.'>All Sections</option>';                                       &Apache::lonstatistics::SectionSelect('Section','multiple',5).
     foreach my $key ( sort keys %section ) {                    '</td>';
  $Ptr .= '<option';      $Str .=  '<td>'.
         if ($CurSec eq $key) {$Ptr .= ' selected';}               &Apache::lonstatistics::GroupSelect('Group','multiple',5).
  $Ptr .= '>'.$key."</option>"."\n";               '</td>';
       $Str .= '<td>'.
           &Apache::lonhtmlcommon::StatusOptions(undef,undef,5).
           '</td>';
       
       $Str .= '</tr>'.$/;
       $Str .= '</table></p>';
       $Str .= '<input type="submit" name="selectstudent" value="'.
           &mt('Update Display').'" />';
       $r->print($Str);
       $r->rflush();
       #
       my @Fields = ('fullname','username','domain','id','section','status','groups');
       #
       $Str = '';
       my @selected_sections = &get_selected_sections();
       if (! @Students) {
           if ($selected_sections[0] eq 'all') { 
               if (lc($env{'form.Status'}) eq 'active') {
                   $Str .= '<p class="LC_info">'.
                   &mt('There are no currently enrolled students in the course.').
                       '</p>';
               } elsif (lc($env{'form.Status'}) eq 'expired') {
                   $Str .= '<p class="LC_info">'.
                       &mt('There are no previously enrolled students in the course.').
                           '</p>';
               } elsif (lc($env{'form.Status'}) eq 'future') {
                   $Str .= '<p class="LC_info">'.
                       &mt('There are no students with future access in the course.').
                           '</p>';
               } else { # 'any' and any others
                  $Str .= '<p class="LC_info">'.
                       &mt('There are no students in the course.').
                       '</p>';
               }
           } else { 
               if (lc($env{'form.Status'}) eq 'active') {
                   $Str .= '<p class="LC_info">'.
                       &mt('There are no currently enrolled students in the selected sections.').
                       '</p>';
               } elsif (lc($env{'form.Status'}) eq 'expired') {
                   $Str .= '<p class="LC_info">'.
                       &mt('There are no previously enrolled students in the selected sections.').
                       '</p>';
               } elsif (lc($env{'form.Status'}) eq 'future') {
                   $Str .= '<p class="LC_info">'.
                       &mt('There are no students with future access in the selected sections.').
                           '</p>';
               } else { # 'any' and any others
                   $Str .= '<p class="LC_info">'.
                       &mt('There are no students in the selected sections.').
                       '</p>';
               }
           }
           $Str.= '<p>'
                 .'<a href="/adm/statistics?reportSelected=student_assessment">'
                 .&mt('Return to the chart').'</a>'
                 .'</p>';
           $r->print($Str);
           $r->rflush();
           return;
     }      }
     $Ptr .= '</select>'."\n";  
   
     $r->print( $Ptr );      $Str .= '<h2>'.&mt('Select One Student').'</h2>'
              .'<p>'.&mt("Click on a student's name or username to view their chart").'</p>'
              .&Apache::loncommon::start_data_table()
              .&Apache::loncommon::start_data_table_header_row();
       foreach my $field (@Fields) {
           $Str .= '<th><a href="/adm/statistics?'.
               'reportSelected=student_assessment&'.
               'selectstudent=1&'.
               'sort='.$field.'">'.&mt($field).
               '</a></th>';
       }
       $Str .= &Apache::loncommon::end_data_table_header_row();
       #
       foreach my $student (@Students) { # @Students is a package variable
           my $sname = $student->{'username'}.':'.$student->{'domain'};
           $Str .= &Apache::loncommon::start_data_table_row();
           #
           foreach my $field (@Fields) {
               $Str .= '<td>';
               if ($field eq 'fullname' || $field eq 'username') {
                   $Str .= '<a href="/adm/statistics?reportSelected=';
                   $Str .= &escape('student_assessment');
                   $Str .= '&sort='.&escape($env{'form.sort'});
                   $Str .= '&SelectedStudent=';
                   $Str .= &escape($sname).'">';
                   $Str .= $student->{$field}.'&nbsp';
                   $Str .= '</a>';
               } elsif ($field eq 'status') {
                   $Str .= &mt($student->{$field});
               } else {
                   $Str .= $student->{$field};
               }
               $Str .= '</td>';
           }
           $Str .= &Apache::loncommon::end_data_table_row();
       }
       $Str .= &Apache::loncommon::end_data_table();
       #
       $r->print($Str);
     $r->rflush();      $r->rflush();
       #
       return;
 }  }
   
   
 # ================================================================ Main Handler  
   
 sub handler {  sub CreateMainMenu {
     $r=shift;      #
       # Define menu data
       my @reports = (
       {categorytitle => 'Statistics and Analyses',
            items => [
               {url => '/adm/statistics?reportSelected=problem_statistics',
    permission => 'F',
                icon => 'document-open.png',
                linktext => ('Overall Problem Statistics'),
                linktitle => ('Student performance statistics on all problems.')},
          
               {url => '/adm/statistics?reportSelected=problem_analysis',
    permission => 'F',
                icon => 'edit-find.png',
                linktext => ('Detailed Problem Analysis'),
                linktitle => ('Detailed statistics and graphs of student performance on problems.')},
            ]},
           {categorytitle => 'Plots',
            items => [
               {url => '/adm/statistics?reportSelected=submissiontime_analysis',
    permission => 'F',
                icon => 'subtimpl.png',
                linktext => ('Submission Time Plots'),
                linktitle => ('Display and analysis of submission times on assessments.')},
         
               {url => '/adm/statistics?reportSelected=correct_problems_plot',
    permission => 'F',
                icon => 'coprplot.png',
                linktext => ('Correct Problems Plot'),
                linktitle => ('Display a histogram of student performance in the course.')},
            ]},
           {categorytitle => 'Reports',
            items => [
               {url => '/adm/statistics?reportSelected=student_submission_reports',
    permission => 'F',
                icon => 'edit-copy.png',
                linktext => ('Student Submission Reports'),
                linktitle => ('Prepare reports of student submissions.')},
                       
               {url => '/adm/statistics?reportSelected=survey_reports',
    permission => 'F',
                icon => 'docs.png',
    linktext => ('Survey Reports'),
                linktitle => ('Prepare reports on survey results.')},
            ]});
       
   return &Apache::lonhtmlcommon::generate_menu(@reports);
    
   }
   
   
     if (&Apache::lonnet::allowed('vgr',$ENV{'request.course.id'})) {  
 # ------------------------------------------- Set document type for header only  
  if ($r->header_only) {  
     if ($ENV{'browser.mathml'}) {  
  $r->content_type('text/xml');  
     }   
     else {  
  $r->content_type('text/html');  
     }  
     $r->send_http_header;  
     return OK;  
  }      
  my $requrl=$r->uri;  
 # ----------------------------------------------------------------- Tie db file  
   
  undef %hash;  
   
  if ($ENV{'request.course.fn'}) {  
     my $fn=$ENV{'request.course.fn'};  
     if (-e "$fn.db") {  
  if (tie(%hash,'GDBM_File',"$fn.db",&GDBM_READER,0640)) {  
 # ------------------------------------------------------------------- Hash tied  
     $r->content_type('text/html');  
     $r->send_http_header;  
     &Menu();  
  }  
  else {  
     $r->content_type('text/html');  
     $r->send_http_header;  
     $r->print('<html><body>Coursemap undefined.</body></html>');  
  }  
 # ------------------------------------------------------------------ Untie hash  
  unless (untie(%hash)) {  
     &Apache::lonnet::logthis("<font color=blue>WARNING: ".  
                             "Could not untie coursemap $fn (browse).</font>");   
  }  
   
 # -------------------------------------------------------------------- All done  
  return OK;  
 # ----------------------------------------------- Errors, hash could no be tied  
     }  
  }   
  else {  
     $ENV{'user.error.msg'}="$requrl:bre:0:0:Course not initialized";  
     return HTTP_NOT_ACCEPTABLE;   
  }  
     }  
     else {  
         $ENV{'user.error.msg'}=  
         $r->uri.":vgr:0:0:Cannot view grades for complete course";  
   
         return HTTP_NOT_ACCEPTABLE;   sub handler {
       my $r=shift;
       my $c = $r->connection();
       #
       # Check for overloading
       my $loaderror=&Apache::lonnet::overloaderror($r);
       if ($loaderror) { return $loaderror; }
       $loaderror=
          &Apache::lonnet::overloaderror($r,
            $env{'course.'.$env{'request.course.id'}.'.home'});
       if ($loaderror) { return $loaderror; }
       #
       # Check for access
       if (! &Apache::lonnet::allowed('vgr',$env{'request.course.id'})) {
           $env{'user.error.msg'}=
               $r->uri.":vgr:0:0:Cannot view grades for complete course";
           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;
           }
       }
       #
       # Send the header
       &Apache::loncommon::no_cache($r);
       &Apache::loncommon::content_type($r,'text/html');
       $r->send_http_header;
       if ($r->header_only) { return OK; }
       #
       # Extract form elements from query string
       &Apache::loncommon::get_unprocessed_cgi($ENV{'QUERY_STRING'},
                                               ['sort','reportSelected',
                                                'SelectedStudent']);
       #
       # Give the LON-CAPA page header
       my $style = <<ENDSTYLE;
   <style type="text/css">
       ul.sub_studentans { list-style-type: none }
       ul.sub_correctans { list-style-type: none }
       tr.even           { background-color: \#CCCCCC }
       td.essay          { border: 1px solid gray; }
   </style>
   ENDSTYLE
         
       $r->print(&Apache::loncommon::start_page('Course Statistics and Charts',
        $style));
       $r->rflush();
       # 
       # Either print out a menu for them or send them to a report
       &Apache::lonhtmlcommon::clear_breadcrumbs();
       &Apache::lonhtmlcommon::add_breadcrumb({href=>'/adm/statistics',
                                               title=>'Statistics',
                                               text =>'Statistics',
                                               faq=>139,
                                               bug=>'Statistics and Charts'});
       if (! exists($env{'form.reportSelected'}) || 
           $env{'form.reportSelected'} eq '') {
           $r->print(&Apache::lonhtmlcommon::breadcrumbs('Statistics Main Page').
                     &CreateMainMenu());
       } else {
       #
           if (! &Apache::lonmysql::verify_sql_connection()) {
               my $serveradmin = $r->dir_config('lonAdmEMail');
               $r->print('<h2 class="LC_error">'.
                         &mt('Unable to connect to database!').
                         '</h2>');
               $r->print('<p>'
                        .&mt('Please notify the server administrator [_1]',
                            ,'<b>'.$serveradmin.'</b>')
                        .'</p>');
               $r->print('<p>'.
                         &mt('Course Statistics and Charts cannot be '.
                             'retrieved until the database is restarted.  '.
                             'Your data is intact but cannot be displayed '.
                             'at this time.').'</p>');
               $r->print(&Apache::loncommon::end_page());
               return;
           }
           #
           # Clean out the caches
           if (exists($env{'form.ClearCache'})) {
               &Apache::loncoursedata::delete_caches($env{'requres.course.id'});
           }
           #
           # Begin form output
           $r->print('<form name="Statistics" ');
           $r->print('method="post" action="/adm/statistics">');
           $r->rflush();
           #
           my $GoToPage = $env{'form.reportSelected'};
           #
           $r->print('<input type="hidden" name="reportSelected" value="'.
                     $GoToPage.'">');
           if($GoToPage eq 'activitylog') {
   #        &Apache::lonproblemstatistics::Activity();
           } elsif($GoToPage eq 'problem_statistics') {
               &Apache::lonhtmlcommon::add_breadcrumb
                   ({href=>'/adm/statistics?reportselected=problem_statistics',
                     text=>'Overall Problem Statistics'});
               &Apache::lonproblemstatistics::BuildProblemStatisticsPage($r,$c);
           } elsif($GoToPage eq 'problem_analysis') {
               &Apache::lonhtmlcommon::add_breadcrumb
                   ({href=>'/adm/statistics?reportselected=problem_analysis',
                     text=>'Detailed Problem Analysis'});
               &Apache::lonproblemanalysis::BuildProblemAnalysisPage($r,$c);
           } elsif($GoToPage eq 'submissiontime_analysis') {
               &Apache::lonhtmlcommon::add_breadcrumb
                   ({href=>
                         '/adm/statistics?reportselected=submissiontime_analysis',
                         text=>'Submission Time Plots'});
               &Apache::lonsubmissiontimeanalysis::BuildSubmissionTimePage($r,$c);
           } elsif($GoToPage eq 'student_submission_reports') {
               &Apache::lonhtmlcommon::add_breadcrumb
                   ({href=>
                     '/adm/statistics?reportselected=student_submission_reports',
                     text=>'Student Submission Reports'});
               &Apache::lonstudentsubmissions::BuildStudentSubmissionsPage($r,$c);
           } elsif($GoToPage eq 'survey_reports') {
               &Apache::lonhtmlcommon::add_breadcrumb
                   ({href=>
                     '/adm/statistics?reportselected=survey_reports',
                     text=>'Survey Reports'});
               &Apache::lonsurveyreports::BuildSurveyReportsPage($r,$c);
           } elsif($GoToPage eq 'correct_problems_plot') {
               &Apache::lonhtmlcommon::add_breadcrumb
                   ({href=>'/adm/statistics?reportselected=correct_problems_plot',
                     text=>'Correct Problems Plot'});
               &Apache::loncorrectproblemplot::BuildCorrectProblemsPage($r,$c);
           } elsif($GoToPage eq 'student_assessment') {
               &Apache::lonhtmlcommon::clear_breadcrumbs();
               &Apache::lonhtmlcommon::add_breadcrumb
                   ({href=>'/adm/statistics?reportselected=student_assessment',
                     text=>'Chart'});
               &Apache::lonstudentassessment::BuildStudentAssessmentPage($r,$c);
           } elsif($GoToPage eq 'grading_analysis') {
               &Apache::lonhtmlcommon::add_breadcrumb
                   ({href=>'/adm/statistics?reportselected=grading_anaylsis',
                     text=>'Grading Analysis'});
               &Apache::longradinganalysis::build_grading_analysis_page($r,$c);
    }
           #
           $r->print("</form>\n");
     }      }
       $r->print(&Apache::loncommon::end_page());
       $r->rflush();
       #
       return OK;
 }  }
   
 1;  1;
   
 __END__  __END__
   
   =pod
   
   =head1 NAME
   
   lonstatistics
   
   =head1 SYNOPSIS
   
   Main handler for statistics and chart.
   
   This is part of the LearningOnline Network with CAPA project
   described at http://www.lon-capa.org.
   
   
   =head1 PACKAGE VARIABLES
   
   =over
   
   =item @FullClasslist The full classlist
   
   =item @Students The students we are concerned with for this invocation
   
   =item @Sections The sections available in this class
   
   =item @Groups The groups available in the class
   
   =item $curr_student The student currently being examined
   
   =item $prev_student The student previous in the classlist
   
   =item $next_student The student next in the classlist
   
   =back
   
   =head1 SUBROUTINES
   
   =over
   
   =item &clear_classlist_variables()
   
   undef the following package variables:
   
   =over 4
   
   =item * @FullClasslist
   
   =item * @Students
   
   =item * @Sections
   
   =item * @Groups
   
   =item * %StudentData
   
   =item * @StudentDataOrder
   
   =item * @SelectedStudentData
   
   =item * $curr_student
   
   =item * $prev_student
   
   =item * $next_student
   
   =back
   
   =item &PrepareClasslist()
   
   Build up the classlist information.  The classlist information is kept in
   the following package variables:
   
   =over 4 
   
   =item * @FullClasslist
   
   =item * @Students
   
   =item * @Sections
   
   =item * @Groups 
   
   =item * %StudentData
   
   =item * @SelectedStudentData
   
   =item * $curr_student
   
   =item * $prev_student
   
   =item * $next_student
   
   =back
   
   $curr_student, $prev_student, and $next_student may not be defined, depending
   upon the calling context.
   
   =item get_selected_sections()
   
   Returns an array of the selected sections
   
   =item get_selected_groups()
                                                                                       
   Returns an array of the selected groups
   
   =item &section_and_enrollment_description()
   
   Returns a string describing the currently selected section(s), group(s) and 
   access status.  
   
   Inputs: mode = 'plaintext' or 'localized'  (defaults to 'localized')
       'plaintext' is used for example in Excel spreadsheets.
   Returns: scalar description string.
   
   =item section_or_group_text()
   
   =item get_students()
   
   Returns a list of the selected students
   
   =item &current_student()
   
   Returns a pointer to a hash containing data about the currently
   selected student.
   
   =item &previous_student()
   
   Returns a pointer to a hash containing data about the student prior
   in the list of students.  Or something. 
   
   =item &next_student()
   
   Returns a pointer to a hash containing data about the next student
   to be viewed. 
   
   =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
   
   =item &get_selected_maps($elementname)
   
   Input: Name of the <select> form element used to specify the maps.
   
   Returns: Array of symbs of selected maps or the description 'all'.
      If form.$elementname does not exist, 'all' is returned.
   
   =item &selected_sequences_with_assessments()
   
   Retrieve the sequences which were selected by the user to show.  
   
   Input: $mode: scalar.  Either 'selected' or 'all'.  If not specified,
       'selected' is used.
   
   Returns: an array containing a navmap object and navmap resources, 
       or an array containing a scalar with an error message.
   
   =item &map_select($elementname,$status,$numvisible,$restriction) 
   
   Returns html for a selection box allowing the user to choose one (or more) 
   of the sequences in the course.  The values of the sequences are the symbs.
   If the top sequence is selected, the value 'top' will result.
   
   =over 4
   
   =item * $elementname The name of the HTML form element
   
   =item * $status 'multiple' or 'single' selection box
   
   =item * $numvisible The number of options to be visible
   
   =back
   
   =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
   
   =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
   
   =item &GroupSelect($elementname,$status,$numvisible)
                                                                                       
   Returns html for a selection box allowing the user to choose one (or more)
   of the groups in the course.
                                                                                       
   Uses the package variables @Groups
   
   =over 4
                                                                                       
   =item * $elementname The name of the HTML form element
                                                                                       
   =item * $status 'multiple' or 'single' selection box
                                                                                       
   =item * $numvisible The number of options to be visible
                                                                                       
   =back
   
   =item CreateMainMenu()
   
   =back
   
   =cut
   

Removed from v.1.5  
changed lines
  Added in v.1.145


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