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

Diff for /loncom/interface/lonstatistics.pm between versions 1.6 and 1.78

version 1.6, 2002/03/02 23:22:32 version 1.78, 2003/06/20 18:50: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/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, 3/2 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 HTML::TokeParser;  use Apache::loncommon;
 use GDBM_File;  use Apache::loncoursedata;
 #use Benchmark;  use Apache::lonhtmlcommon;
   use Apache::lonproblemanalysis();
 # -------------------------------------------------------------- Module Globals  use Apache::lonproblemstatistics();
 my %hash;  use Apache::lonstudentassessment();
 my %CachData;  use Apache::lonpercentage;
 my %GraphDat;  use Apache::lonmysql;
 my %maps;  use Time::HiRes;
 my %mapsort;  
 my %section;  #######################################################
 my %StuBox;  #######################################################
 my %DiscFac;  
 my $CurMap;  =pod
 my $CurSec;  
 my $CurStu;  =item Package Variables
 my @cols;  
 my @list;  =item @FullClasslist The full classlist
 my @students;  
 my $p_count;  =item @Students The students we are concerned with for this invocation
 my $Pos;  
 my $r;  =item @Sections The sections available in this class
 my $OpSel1;  
 my $OpSel2;  =item $curr_student The student currently being examined
 my $OpSelDis1;  
 my $OpSelDis2;  =item $prev_student The student previous in the classlist
 my $CurDis=0;  
 my $OpSel3;  =item $next_student The student next in the classlist
 my $OpSel4;  
 my $GData;  =over
 my $cid;  
 my $firstres;  =cut 
 my $lastres;  
 my $DiscFlag;  #######################################################
 my $HWN;  #######################################################
 my $P_Order;  #
 my %Header = (0,"Homework Sets Order",1,"#Stdnts",2,"Tries",3,"Mod",  # Classlist variables
               4,"Mean",5,"#YES",6,"#yes",7,"%Wrng",8,"DoDiff",  #
               9,"S.D.",10,"Skew.",11,"Map");  my $curr_student;
 #             11,"Dis.F.",12,"Resourse URL");  my $prev_student;
   my $next_student;
   
   #######################################################
   #######################################################
   
 sub NumericSort {            =pod
     $a <=> $b;  
   =item &clear_classlist_variables()
   
   undef the following package variables:
   
   =over
   
   =item @FullClasslist
   
   =item @Students
   
   =item @Sections
   
   =item @SelectedSections
   
   =item %StudentData
   
   =item @StudentDataOrder
   
   =item @SelectedStudentData
   
   =item $curr_student
   
   =item $prev_student
   
   =item $next_student
   
   =back
   
   =cut
   
   #######################################################
   #######################################################
   sub clear_classlist_variables {
       undef(@FullClasslist);
       undef(@Students);
       undef(@Sections);
       undef(@SelectedSections);
       undef(%StudentData);
       undef(@SelectedStudentData);
       undef($curr_student);
       undef($prev_student);
       undef($next_student);
 }  }
   
 # ------ Create different Student Report   #######################################################
 sub StudentReport {  #######################################################
     my ($sname,$sdom)=@_;  
     if ( $sname eq 'All Students' ) {  =pod
  $r->print( '<h3><font color=blue>WARNING:   
                     Please select a student</font></h3>' );  =item &PrepareClasslist()
  return;  
     }  Build up the classlist information.  The classlist information is kept in
     my $shome=&Apache::lonnet::homeserver( $sname,$sdom );            the following package variables:
     my $reply=&Apache::lonnet::reply('dump:'.$sdom.':'.$sname.':'.$cid,$shome );  
     my %result = ();  =over
     my $ResId;  
     my $PrOrd;  =item @FullClasslist
     my $Code;  
     my $Tries;  =item @Students
     my $TotalTries = 0;  
     my $ParCr = 0;  =item @Sections
     my $Wrongs;  
     my %TempHash;  =item @SelectedSections
     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.'___'.  =item %StudentData
                        &Apache::lonnet::declutter( $hash{'src_'.$ResId} );  
             $Code='U';  =item @SelectedStudentData
             $Tries = 0;  
             $Wrongs = 0;  =item $curr_student
      $LatestVersion = $result{"version:$Prob"};         
   =item $prev_student
     if ( $LatestVersion ) {  
  for ( my $Version=1; $Version<=$LatestVersion; $Version++ ) {  =item $next_student
     my $vkeys = $result{"$Version:keys:$Prob"};  
     my @keys = split(/\:/,$vkeys);  =back
     
     foreach my $Key (@keys) {    $curr_student, $prev_student, and $next_student may not be defined, depending
  if (($Key=~/\.(\w+)\.solved$/) && ($Key!~/^\d+\:/)) {  upon the calling context.
     my $Part = $1;  
     $Tries = $result{"$Version:$Prob:resource.$Part.tries"};  =cut
     $TempHash{"$Part.Tries"} = ($Tries) ? $Tries : 0;   
     $TotalTries += $Tries;  #######################################################
     my $Val = $result{"$Version:$Prob:resource.$Part.solved"};  #######################################################
     if ( $Val eq 'correct_by_student' )  sub PrepareClasslist {
                                 { $Wrongs = $Tries - 1; $Code = 'Y'; }       my %Sections;
     elsif ( $Val eq 'correct_by_override' )      &clear_classlist_variables();
                                 { $Wrongs = $Tries - 1; $Code = 'y'; }                              #
     elsif ( $Val eq 'incorrect_attempted' ||       # Retrieve the classlist
                                 $Val eq 'incorrect_by_override' )      my $cid  = $ENV{'request.course.id'};
                 { $Wrongs = $Tries; $Code = 'N'; }      my $cdom = $ENV{'course.'.$cid.'.domain'};
     $TempHash{"$Part.Code"} = $Code;      my $cnum = $ENV{'course.'.$cid.'.num'};
     $TempHash{"$Part.Wrongs"} = $Wrongs;      my ($classlist,$field_names) = &Apache::loncoursedata::get_classlist($cid,
  }                                                                    $cdom,$cnum);
          }      if (exists($ENV{'form.Section'})) {
                 }           if (ref($ENV{'form.Section'})) {
  for ( my $n = 0; $n < $PartNo; $n++ ) {                @SelectedSections = @{$ENV{'form.Section'}};
     my $part = $TempHash{$n};          } elsif ($ENV{'form.Section'} !~ /^\s*$/) {
     if ($PtrTry ne '') {$PtrTry .= ',';}              @SelectedSections = ($ENV{'form.Section'});
     $PtrTry .= "$TempHash{$part.'.Tries'}";          }
                     $PtrCod .= "$TempHash{$part.'.Code'}";          }
  }      @SelectedSections = ('all') if (! @SelectedSections);
       foreach (@SelectedSections) {
           if ($_ eq 'all') {
               @SelectedSections = ('all');
           }
       }
       #
       # Deal with instructors with restricted section access
       if ($ENV{'request.course.sec'} !~ /^\s*$/) {
           @SelectedSections = ($ENV{'request.course.sec'});
       }
       #
       # Set up %StudentData
       @StudentDataOrder = qw/fullname username domain id section status/;
       foreach my $field (@StudentDataOrder) {
           $StudentData{$field}->{'title'} = $field;
           $StudentData{$field}->{'base_width'} = length($field);
           $StudentData{$field}->{'width'} = 
                                  $StudentData{$field}->{'base_width'};
       }
       #
       # get the status requested
       my $requested_status = 'Active';
       $requested_status = $ENV{'form.Status'} if (exists($ENV{'form.Status'}));
       #
       # Process the classlist
       while (my ($student,$student_data) = each (%$classlist)) {
           my $studenthash = ();
           for (my $i=0; $i< scalar(@$field_names);$i++) {
               my $field = $field_names->[$i];
               # Store the data
               $studenthash->{$field}=$student_data->[$i];
               # Keep track of the width of the fields
               next if (! exists($StudentData{$field}));
               my $length = length($student_data->[$i]);
               if ($StudentData{$field}->{'width'} < $length) {
                   $StudentData{$field}->{'width'} = $length; 
               }
           }
           push (@FullClasslist,$studenthash);
           #
           # Build up a list of sections
           my $section = $studenthash->{'section'};
           if (! defined($section) || $section =~/^\s*$/ || $section == -1) {
               $studenthash->{'section'} = 'none';
               $section = $studenthash->{'section'};
           }
           $Sections{$section}++;
           #
           # Only put in the list those students we are interested in
           foreach my $sect (@SelectedSections) {
               if ( (($sect eq 'all') || 
                     ($section eq $sect)) &&
                    (($studenthash->{'status'} eq $requested_status) || 
                     ($requested_status eq 'Any')) 
                    ){
                   push (@Students,$studenthash);
                   last;
             }              }
     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 {
           @Sections = sort {$a cmp $b} keys(%Sections);
           unshift(@Sections,'all'); # Put 'all' at the front of the list
       }
       #
       # Sort the Students
       my $sortby = 'fullname';
       $sortby = $ENV{'form.sort'} if (exists($ENV{'form.sort'}));
       my @TmpStudents = sort { $a->{$sortby} cmp $b->{$sortby} ||
                                $a->{'fullname'} cmp $b->{'fullname'} } @Students;
       @Students = @TmpStudents;
       # 
       # Now deal with that current student thing....
       $curr_student = undef;
       if (exists($ENV{'form.SelectedStudent'})) {
           my ($current_uname,$current_dom) = 
               split(':',$ENV{'form.SelectedStudent'});
           my $i;
           for ($i = 0; $i<=$#Students; $i++) {
               next if (($Students[$i]->{'username'} ne $current_uname) || 
                        ($Students[$i]->{'domain'}   ne $current_dom));
               $curr_student = $Students[$i];
               last; # If we get here, we have our student.
           }
           if (defined($curr_student)) {
               if ($i == 0) {
                   $prev_student = undef;
               } else {
                   $prev_student = $Students[$i-1];
               }
               if ($i == $#Students) {
                   $next_student = undef;
               } else {
                   $next_student = $Students[$i+1];
               }
           }
       }
       #
       if (exists($ENV{'form.StudentData'})) {
           if (ref($ENV{'form.StudentData'}) eq 'ARRAY') {
               @SelectedStudentData = @{$ENV{'form.StudentData'}};
           } else {
               @SelectedStudentData = ($ENV{'form.StudentData'});
           }
       } else {
           @SelectedStudentData = ('username');
       }
       foreach (@SelectedStudentData) {
           if ($_ eq 'all') {
               @SelectedStudentData = ('all');
               last;
           }
       }
       #
       return;
 }  }
   
 sub CreateTable {  
     my ($Hd, $Hid)=@_;  #######################################################
     if ( $Hd == 1 ) {  #######################################################
 # $Hid=~/(\d+)\.(\d+)/;  
  $r->print('<br><a href="'.$hash{'src_'.$Hid}.  =pod
                   '" target="_blank">'.$hash{'title_'.$Hid}.'</a>'  
 #                  .' ('.&Apache::lonnet::declutter($hash{'map_id_'.$1}).')'  =item get_students
                  );  
     }  Returns a list of the selected students
     my $Result = "\n".'<table border=2>';  
     $Result .= '<tr><th>P#</th>'."\n";  =cut
     for ( my $nIdx=0; $nIdx < 11; $nIdx++ ) {   
  $Result .= '<th>'.'<input type="submit" name="sort" value="'.  #######################################################
                    $Header{$nIdx}.'" />'.'</th>'."\n";  #######################################################
   sub get_students {
       if (! @Students) {
           &PrepareClasslist()
     }      }
     $Result .= "\n".'</tr>'."\n";          return @Students;
     $r->print( $Result );  
     $r->rflush();  
 }  }
   
 sub CloseTable {  #######################################################
     $r->print("\n".'</table>'."\n");  #######################################################
     $r->rflush();  
 }  =pod
    
 # ------------------------------------------- Prepare Statistics Table  =item &current_student()
 sub PreStatTable {  
     my $CacheDB = "/home/httpd/perl/tmp/$ENV{'user.name'}".  Returns a pointer to a hash containing data about the currently
                   "_$ENV{'user.domain'}_$cid\_statistics.db";  selected student.
     my $GraphDB = "/home/httpd/perl/tmp/$ENV{'user.name'}".  
                   "_$ENV{'user.domain'}_$cid\_graph.db";  =cut
     my $CachDisFac = "/home/httpd/perl/tmp/$ENV{'user.name'}".  
      "_$ENV{'user.domain'}_$cid\_DiscFactor.db";  #######################################################
     my $OpSel11='';  #######################################################
     my $OpSel12='';  sub current_student { 
     my $OpSel13='';      return $curr_student;
     my $Status = $ENV{'form.status'};  
     if ( $Status eq 'Any' ) { $OpSel13='selected'; }  
     elsif ($Status eq 'Expired' ) { $OpSel12 = 'selected'; }  
     else { $OpSel11 = 'selected'; }  
   
     my $Ptr = '';  
     $Ptr .= '<br><b> Student Status: &nbsp; </b>'."\n".  
             '<select name="status">'.   
             '<option '.$OpSel11.' >Active</option>'."\n".  
             '<option '.$OpSel12.' >Expired</option>'."\n".  
     '<option '.$OpSel13.' >Any</option> </select> '."\n";  
     $Ptr .= '&nbsp;&nbsp;&nbsp;';  
     $Ptr .= '<input type=submit name=sort value="Recalculate Statistics"/>'."\n";  
   
     $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)));  
   
     untie(%CachData);  
     untie(%GraphDat);  
     untie(%DiscFac);         
 }  }
   
   #######################################################
   #######################################################
   
 # ------------------------------------- Find the section of student in a course  =pod
   
 sub usection {  =item &previous_student()
     my ($udom,$unam,$courseid,$ActiveFlag)=@_;  
     $courseid=~s/\_/\//g;  Returns a pointer to a hash containing data about the student prior
     $courseid=~s/^(\w)/\/$1/;  in the list of students.  Or something.  
     foreach (split(/\&/,&Apache::lonnet::reply('dump:'.  
              $udom.':'.$unam.':roles',  =cut
              &Apache::lonnet::homeserver($unam,$udom)))){  
         my ($key,$value)=split(/\=/,$_);  #######################################################
         $key=&Apache::lonnet::unescape($key);  #######################################################
         if ($key=~/^$courseid(?:\/)*(\w+)*\_st$/) {  sub previous_student { 
             my $section=$1;      return $prev_student;
             if ($key eq $courseid.'_st') { $section=''; }  
     my ($dummy,$end,$start)=split(/\_/,&Apache::lonnet::unescape($value));  
     if ( $ActiveFlag ne 'Any' ) {  
  my $now=time;  
  my $notactive=0;  
  if ($start) {  
     if ($now<$start) { $notactive=1; }  
  }  
  if ($end) {  
     if ($now>$end) { $notactive=1; }  
  }  
  if ((($ActiveFlag eq 'Expired') && $notactive == 1) ||   
                     (($ActiveFlag eq 'Active') && $notactive == 0 ) ) {  
     return $section;  
  }  
  else { return '-1'; }   
     }  
     return $section;  
         }  
     }  
     return '-1';  
 }  }
   
   #######################################################
   #######################################################
   
 # ------ Dump the Student's DB file and handling the data for statistics table   =pod
   
 sub ExtractStudentData {  =item &next_student()
     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.'___'.  Returns a pointer to a hash containing data about the next student
                        &Apache::lonnet::declutter( $hash{'src_'.$ResId} );  to be viewed.
             $Code='U';  
             $Tries = 0;  =cut
     $ParCr = 0;  
             $Wrongs = 0;  #######################################################
      $LatestVersion = $result{"version:$Prob"};         #######################################################
   sub next_student { 
     if ( $LatestVersion ) {      return $next_student;
  for ( my $Version=1; $Version<=$LatestVersion; $Version++ ) {  
     my $vkeys = $result{"$Version:keys:$Prob"};  
     my @keys = split(/\:/,$vkeys);  
     
     foreach my $Key (@keys) {    
  if (($Key=~/\.(\w+)\.solved$/) && ($Key!~/^\d+\:/)) {  
     my $Part = $1;  
     $Tries = $result{"$Version:$Prob:resource.$Part.tries"};  
     $ParCr = $result{"$Version:$Prob:resource.$Part.awarded"};  
     my $Time = $result{"$Version:$Prob:timestamp"};  
     $TempHash{"$Part.Time"} = ($Time) ? $Time : 0;  
     $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>');  
 }  }
   
   #######################################################
   #######################################################
   
 # ------------------------------------------------------------ Build page table  =pod
 sub tracetable {  
     my ($rid,$beenhere)=@_;  =item &clear_sequence_variables()
     $rid=~/(\d+)\.(\d+)/;  
     $maps{&Apache::lonnet::declutter($hash{'map_id_'.$1})}='';#$hash{'title_'.$rid};   =cut
     #$maps{$HWN}=$hash{'title_'.$rid};   
     unless ($beenhere=~/\&$rid\&/) {  #######################################################
        $beenhere.=$rid.'&';   #######################################################
        if (defined($hash{'is_map_'.$rid})) {  sub clear_sequence_variables {
    my $cmap=$hash{'map_type_'.$hash{'map_pc_'.$hash{'src_'.$rid}}};      undef($top_map);
            if ( $cmap eq 'sequence' || $cmap eq 'page' ) {       undef(@Sequences);
                $cols[$#cols+1]=0;      undef(@Assessments);
        $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;  
         
        my $meta=$hash{'src_'.$frid};  
        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++;  
        $r->print('<br>'.$PartNo.'---'.$P_Order);  
    }  
        }  
    }  
                }  
    }  
        } else {  
    $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 ) {  #######################################################
  if ($ENV{'form.order'} eq 'Descending') {$b <=> $a;}  
  else { $a <=> $b; }  =pod
     }  
     else {  =item &SetSelectedMaps($elementname)
  if ($ENV{'form.order'} eq 'Descending') {$b cmp $a;}  
  else { $a cmp $b; }  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');
     }      }
 }  }
   
 sub Build_Statistics {  
     $r->print(<<ENDPOP);  
     <script>  
     popwin=open('','popwin','width=400,height=100');  
     popwin.document.writeln('<html><body bgcolor="#88CC88">'+  
       '<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();  #######################################################
 # ---------------------------- Gathering the Data of students' tries  #######################################################
     my $index;  
     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);  =pod
     }  
 #--------------------- close Progress Line  =item &Sequences_with_Assess()
     $r->print('<script>popwin.close()</script>');  
     $r->rflush();   Returns an array containing the subset of @Sequences which contain
 # -------------------- sorting the Data  assessments.
     @list = sort (@list);  
   =cut
     $OpSel2='';  
     $OpSel1='selected';  #######################################################
       #######################################################
     $p_count = 0;   sub Sequences_with_Assess {
     my $nIdx = 0;      my @Sequences_to_Show;
     my $dummy;       foreach my $map_symb (@SelectedMaps) {
     my $p_val;          foreach my $sequence (@Sequences) {
     my $ResId;              next if ($sequence->{'symb'} ne $map_symb && $map_symb ne 'all');
     my $NoElements = $#list + 1;              next if ($sequence->{'num_assess'} < 1);
 #-------------------------------- loop for data representation              push (@Sequences_to_Show,$sequence);
     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  
     my $Average = ($StdNo) ? $TotalTries/$StdNo : 0;  
   
     $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.':'.$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();  
     }      }
       return @Sequences_to_Show;
 }  }
   
 sub Cache_Statistics {  #######################################################
     my @list = ();  #######################################################
     my $Useful;  
     my $UnUseful;  =pod
     my %myHeader = reverse( %Header );  
     $Pos = $myHeader{$ENV{'form.sort'}};  =item &PrepareCourseData($r)
     if ($Pos > 0) {$Pos++;}  
     $p_count = 0;  =cut
     foreach my $key( keys %CachData) {   
  my @Temp=split(/\:/,$CachData{$key});  #######################################################
  if ( $Pos == 0 ) {  #######################################################
     ($UnUseful,$Useful)=split(/\>/,$Temp[$Pos]);  sub PrepareCourseData {
  }      my ($r) = @_;
  else {      &clear_sequence_variables();
     $Useful = $Temp[$Pos];      my ($top,$sequences,$assessments) = 
  }             &Apache::loncoursedata::get_sequence_assessment_data();
  $list[$p_count]=$Useful.'&'.$CachData{$key};      if (! defined($top) || ! ref($top)) {
         $p_count++;          # There has been an error, better report it
     }          &Apache::lonnet::logthis('top is undefined');
           return;
     @list = sort MySort (@list);      }
       $top_map = $top if (ref($top));
     my $nIdx=0;      @Sequences = @{$sequences} if (ref($sequences) eq 'ARRAY');
       @Assessments = @{$assessments} if (ref($assessments) eq 'ARRAY');
     if ( $Pos == 0 ) {      #
  foreach (sort keys %mapsort) {      # Compute column widths
     my ($Hid,$pr)=split(/\:/,$mapsort{$_});      foreach my $seq (@Sequences) {
     &CreateTable(1,$Hid);          my $name_length = length($seq->{'title'});
     my @lpr=split(/\&/,$pr);          my $num_parts = $seq->{'num_assess_parts'};
     for (my $i=1; $i<=$#lpr; $i++) {          #
  my($Pre, $Post) = split(/\&/,$list[$nIdx]);           # Use 3 digits for each the sum and total, which means 7 total...
  &TableRow($Post,$i,$nIdx);          my $num_col = $num_parts+7;
  $nIdx++;          if ($num_col < $name_length) {
     }              $num_col = $name_length;
     &CloseTable();          }
  }          $seq->{'base_width'} = $name_length;
     }          $seq->{'width'} = $num_col;
     else {  
  &CreateTable(0);  
  for ( my $nIdx = 0; $nIdx < $p_count; $nIdx++ ) {  
     my($Pre, $Post) = split(/\&/,$list[$nIdx]);   
     &TableRow($Post,$nIdx,$nIdx);  
  }   
  &CloseTable();  
     }      }
       return;
 }  }
   
 sub TableRow {  #######################################################
     my ($Str,$Idx,$RealIdx)=@_;  #######################################################
     my($PrOrd,$Temp,$StdNo,$TotalTries,$MxTries,$Avg,$YES,  
        $Override,$Wrng,$DoD,$SD,$Sk,$Prob)=split(/\:/,$Str);  =pod
     $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  =item &log_sequence($sequence,$recursive,$padding)
   
 sub GetGraphData {  Write data about the sequence to a logfile.  If $recursive is not
     my $Tag = shift;  undef the data is written recursively.  $padding is used for recursive
     my $Col;  calls.
     my $data='';  
     my $count = 0;  =cut
     my $Max = 0;  
     my $cid=$ENV{'request.course.id'};  #######################################################
     my $GraphDB = "/home/httpd/perl/tmp/$ENV{'user.name'}".  #######################################################
                   "_$ENV{'user.domain'}_$cid\_graph.db";  sub log_sequence {
     foreach (keys %GraphDat) {delete $GraphDat{$_};}      my ($seq,$recursive,$padding) = @_;
     if (-e "$GraphDB") {      $padding = '' if (! defined($padding));
  if (tie(%GraphDat,'GDBM_File',"$GraphDB",&GDBM_READER,0640)) {      if (ref($seq) ne 'HASH') {
     if ( $Tag eq 'DoDiff Graph' ) {          &Apache::lonnet::logthis('log_sequence passed bad sequnce');
  $Tag = 'Degree-of-Difficulty';          return;
  $Col = 0;      }
     }      &Apache::lonnet::logthis($padding.'sequence '.$seq->{'title'});
     else {      while (my($key,$value) = each(%$seq)) {
  $Tag = 'Wrong-Percentage';          next if ($key eq 'contents');
  $Col = 1;          if (ref($value) eq 'ARRAY') {
     }              for (my $i=0;$i< scalar(@$value);$i++) {
     foreach (sort NumericSort keys %GraphDat) {                   &Apache::lonnet::logthis($padding.$key.'['.$i.']='.
  my @Temp=split(/\:/,$GraphDat{$_});                                           $value->[$i]);
                 my $inf = $Temp[$Col];               }
  if ( $Max < $inf ) {$Max = $inf;}          } else {
  $data .= $inf.',';              &Apache::lonnet::logthis($padding.$key.'='.$value);
  $count++;          }
     }      }
             untie(%GraphDat);      if (defined($recursive)) {
     my $Course = $ENV{'course.'.$cid.'.description'};          &Apache::lonnet::logthis($padding.'-'x20);
     $Course =~ s/\ /"_"/eg;          &Apache::lonnet::logthis($padding.'contains:');
     $GData=$Course.'&'.$Tag.'&'.$Max.'&'.$count.'&'.$data;          foreach my $item (@{$seq->{'contents'}}) {
               if ($item->{'type'} eq 'container') {
  }                  &log_sequence($item,$recursive,$padding.'    ');
  else {              } else {
     $r->print("Unable to tie hash to db file");                  &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;
 }  }
   
   ##############################################
   ##############################################
   
 sub initial {  =pod 
 # --------------------------------- 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;  
 }  
   
   =item &StudentDataSelect($elementname,$status,$numvisible,$selected)
   
 sub ClassList {  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)
   
     &GetStatus();  =over 4
   
     $cid=$ENV{'request.course.id'};  =item $elementname The name of the HTML form element
     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;  
  my $now=time;  
  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 $active=1;  
  my $Status=$ENV{'form.status'};  
  $Status = ($Status) ? $Status : 'Active';  
  if ( ( ($end) && $now > $end ) &&   
                      ( ($Status eq 'Active') ) ) { $active=0; }  
  if ( ($Status eq 'Expired') &&   
                      ($end == 0 || $now < $end) ) { $active=0; }  
  if ($active) {  
     my $thisindex=$#students+1;  
     $name=&Apache::lonnet::unescape($name);  
     $students[$thisindex]=$name;  
     my ($sname,$sdom)=split(/\:/,$name);  
   
     #my %reply=&Apache::lonnet::idrget($sdom,$sname);  
     #my $reply=&Apache::lonnet::reply('get:'.$sdom.':'.$sname.  
     #         ':environment:lastname&generation&firstname&middlename',  
     #         &Apache::lonnet::homeserver($sname,$sdom));  
     my $ssec=&usection($sdom,$sname,$cid,$Status);  
     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;  =item $status 'multiple' or 'single' selection box
 #    foreach (sort keys %mapsort) {  
 # $r->print('<br>'.$c.')'.$_.' ... '.$mapsort{$_});  
 # $c++;  
 #    }  
 #foreach(@cols) {  
 #    $c++;  
 #    $r->print('<br>'.$cols[$c]);  
 #}  
 #$r->print('<br> Count = '.$c);  
   
     }  =item $numvisible The number of options to be visible
   
   =back
   
 # ------------------------------------------------------------- End render page   =cut
     else {  
  $r->print('<h3>Undefined course sequence</h3>');  ##############################################
   ##############################################
   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;
           }
     }      }
     &MapSecOptions();      $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
   
 sub Menu {  =item $status 'multiple' or 'single' selection box
     my $InpStr = $ENV{'form.sort'};  
     if ( $InpStr eq 'DoDiff Graph' || $InpStr eq '%Wrong Graph' ) {        =item $numvisible The number of options to be visible
  &GetGraphData($InpStr);  
     $r->print('<IMG src="/cgi-bin/graph.gif?'.$GData.'" />');  =item $restriction Code reference to subroutine which returns true or 
     }  false.  The code must expect a reference to a sequence data structure.
     else {  
  $r->print('<html><head><title>LON-CAPA Statistics</title></head>');  =back
   
   =cut
         $r->print('<body bgcolor="#FFFFFF">'.  
                   '<script>window.focus(); window.width=500;window.height=500; </script>'.  ##############################################
                   '<img align=right src=/adm/lonIcons/lonlogos.gif>');  ##############################################
 # ---------------------------------------------------------------- Course title  sub MapSelect {
         $r->print('<h1> Course : "'.      my ($elementname,$status,$numvisible,$restriction)=@_;
                   $ENV{'course.'.$ENV{'request.course.id'}.      if ($numvisible < 1) {
                   '.description'}.'"</h1><h2>'.localtime().'</h2>');          return;
 # ------------------------------- This is going to take a while, produce output      }
         $r->rflush();      #
       # Set up array of selected items
  $r->print("\n".'<form name=stat method=post action="/adm/statistics" >');      &SetSelectedMaps($elementname);
       #
  my $content = $ENV{'form.sort'};      # Set up the restriction call
  if ($content eq '' || $content eq 'Return to Menu') {      if (! defined($restriction)) {
     my $Ptr = '<h3>';          $restriction = sub { 1; };
     $Ptr .= '<input type=submit name=sort value="Problem Evaluation"/>';#General Statistics"/>';  
     $Ptr .= '<br><br>';  
     $Ptr .= '<input type=submit name=sort value="Student Assessment"/>';  
     $Ptr .= '<br><br>';  
 #    $Ptr .= '<input type=submit name=sort value=Discrimination>';#"Problem Evaluation"/>';  
     $Ptr .= '</h3>';  
     $r->print( $Ptr );  
       }  
  else {  
     &initial();  
     &ClassList();  
     if ( $content eq 'Discrimination' || #'Problem Evaluation' ||  
                  $content eq 'Recalculate Discrimintion Factor' ) {  
  &CreateDiscFac();  
     }  
     elsif ( $content eq 'Student Assessment' ||   
                     $content eq 'Create Student Report' ) {  
  &StudentOptions();  
  &StudentReport($CurStu,$StuBox{"$CurStu"});  
     }  
     else {  
  &PreStatTable();  
     }  
  }  
  $r->print("\n".'</form>'.  
                   "\n".'</body>'.  
                   "\n".'</html>');  
  $r->rflush();  
     }      }
       #
       # 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 StudentOptions {  ##############################################
     my $OpSel5='';  ##############################################
     $CurStu = $ENV{'form.student'};  
     if ( $CurStu eq '' ) {   
         $CurStu = 'All Students';  
         $OpSel5 = 'selected';  
     }  
     my $Ptr ='';  
 # ----------------------------------- Loading the Students Combobox  
     $Ptr .= '<br><b>Select Student</b>'."\n".  
            '<select name="student">'."\n".   
     '<option '.$OpSel5.'>All Students</option>';                               
     foreach my $key ( sort keys %StuBox ) {            
  $Ptr .= '<option';  
  if ($CurStu eq $key) {$Ptr .= ' selected';}       
         $Ptr .= '>'.$key."</option>\n";       
     }  
     $Ptr .= '</select>';  
     $Ptr .= '<br><input type="submit" name="sort" value="Create Student Report" />';  
     $r->print( $Ptr );  
     $r->rflush();  
 }  
   
 sub GetStatus {  =pod 
   
     $OpSelDis1='';  =item &SectionSelect($elementname,$status,$numvisible) 
     $OpSelDis2='';  
     $OpSel1='';  Returns html for a selection box allowing the user to choose one (or more) 
     $OpSel2='';  of the sections in the course.  
     $OpSel3='';  
     $OpSel4='';  Uses the package variables @Sections and @SelectedSections
   =over 4
 #    if ( $ENV{'form.DisType'} eq 'Total Number of Correct Answers' ) {   
 # $OpSelDis1='selected';   =item $elementname The name of the HTML form element
 # $CurDis=0;  
 #    }  
 #    else { $OpSel2 = 'selected'; $CurDis = 1;}  
   
     if ( $ENV{'form.order'} eq 'Descending' ) { $OpSel2='selected'; }  =item $status 'multiple' or 'single' selection box
     else { $OpSel1 = 'selected'; }  
   
     my %myHeader = reverse( %Header );  =item $numvisible The number of options to be visible
     $Pos = $myHeader{$ENV{'form.sort'}};  
     if ($Pos == 0) {  =back
  $OpSel1 = 'selected';  
  $ENV{'form.order'}='Ascendig';  =cut
     }  
   ##############################################
     $CurMap = $ENV{'form.maps'};  ##############################################
     if ( $CurMap eq '' ) {   sub SectionSelect {
  $CurMap = 'All Maps';      my ($elementname,$status,$numvisible)=@_;
  $OpSel3 = 'selected';      if ($numvisible < 1) {
     }          return;
     $CurSec = $ENV{'form.section'};      }
     if ( $CurSec eq '' ) {       #
  $CurSec = 'All Sections';      # Make sure we have the data we need to continue
         $OpSel4 = 'selected';      if (! @Sections) {
           &PrepareClasslist()
       }
       #
       # Build the form element
       my $Str = "\n";
       $Str .= '<select name="'.$elementname.'" ';
       if ($status ne 'single') {
           $Str .= 'multiple="true" ';
       }
       $Str .= 'size="'.$numvisible.'" >'."\n";
       #
       # Loop through the sequences
       foreach my $s (@Sections) {
           $Str .= '    <option value="'.$s.'" ';
           foreach (@SelectedSections) {
               if ($s eq $_) {
                   $Str .= 'selected ';
                   last;
               }
           }
           $Str .= '>'.$s."</option>\n";
     }      }
       $Str .= "</select>\n";
       return $Str;
 }  }
   
   ##################################################
 sub MapSecOptions {  ##################################################
 # ----------------------------------- Loading the Maps Combobox  sub DisplayClasslist {
     my $Ptr = '<br>';      my ($r)=@_;
     $Ptr .= '<br><input type="submit" name="sort" value="Return to Menu" />';      #
     $Ptr .= '<br><b> Select &nbsp; Map &nbsp; &nbsp; </b>'."\n".      my @Fields = ('fullname','username','domain','id','section');
            '<select name="maps">'."\n".       #
     '<option '.$OpSel3.'>All Maps</option>';                                   my $Str='';
     foreach my $key ( sort keys %maps ) {                if (! @Students) {
  $Ptr .= '<option';          if ($SelectedSections[0] eq 'all') { 
         if ($CurMap eq $key) {$Ptr .= ' selected';}                   if (lc($ENV{'form.Status'}) eq 'any') {
  $Ptr .= '>'.$key."</option>\n";                       $Str .= '<h2>There are no students in the course.</h2>';
     }              } elsif (lc($ENV{'form.Status'}) eq 'active') {
     $Ptr .= '</select>';                  $Str .= '<h2>There are no currently enrolled students in '.
     $Ptr .= '&nbsp;&nbsp;&nbsp;';                      'the course.</h2>';
               } elsif (lc($ENV{'form.Status'}) eq 'expired') {
 # ----------------------------------- Loading the Sections Combobox                  $Str .= '<h2>There are no previously enrolled '.
     $Ptr .= '<br><b>Select Section</b>'."\n".                      'students in the course.</h2>';
            '<select name="section">'."\n".               }
     '<option '.$OpSel4.'>All Sections</option>';                                       } else { 
     foreach my $key ( sort keys %section ) {                        my $sections;
  $Ptr .= '<option';              if (@SelectedSections == 1) {
         if ($CurSec eq $key) {$Ptr .= ' selected';}                       $sections = 'section '.$SelectedSections[0];
  $Ptr .= '>'.$key."</option>"."\n";                   } elsif (@SelectedSections > 2) {
                   $sections = 'sections '.join(', ',@SelectedSections);
                   $sections =~ s/, ([^,])*$/, and $1/;
               } else {
                   $sections = 'sections '.join(' and ',@SelectedSections);
               }
               if (lc($ENV{'form.Status'}) eq 'any') {
                   $Str .= '<h2>There are no students in '.$sections.'.</h2>';
               } elsif (lc($ENV{'form.Status'}) eq 'active') {
                   $Str .= '<h2>There are no currently enrolled students '.
                       'in '.$sections.'.</h2>';
               } elsif (lc($ENV{'form.Status'}) eq 'expired') {
                   $Str .= '<h2>There are no previously enrolled students '.
                       'in '.$sections.'.</h2>';
               }
           }
           $Str.= '<a href="/adm/statistics?reportSelected=student_assessment">'.
               'Return to the chart.</a>';
           $r->print($Str);
           $r->rflush();
           return;
     }      }
     $Ptr .= '</select>'."\n";  
   
     $r->print( $Ptr );      # "Click" is asinine but it is probably not my place to change the world.
       $Str .= '<h2>Click on a students name or username to view their chart</h2>';
       $Str .= '<table border="0"><tr><td bgcolor="#777777">'."\n";
       $Str .= '<table border="0" cellpadding="3"><tr bgcolor="#e6ffff">'."\n";
       foreach my $field (@Fields) {
           $Str .= '<th><a href="/adm/statistics?reportSelected=classlist&sort='.$field.'">'.$field.
               '</a></th>';
       }
       $Str .= '</tr>'."\n";
       #
       my $alternate = 0;
       foreach my $student (@Students) { # @Students is a package variable
           my $sname = $student->{'username'}.':'.$student->{'domain'};
           if($alternate) {
               $Str .= '<tr bgcolor="#ffffe6">';
           } else {
               $Str .= '<tr bgcolor="#ffffc6">';
           }
           $alternate = ($alternate + 1) % 2;
           #
           foreach my $field (@Fields) {
               $Str .= '<td>';
               if ($field eq 'fullname' || $field eq 'username') {
                   $Str .= '<a href="/adm/statistics?reportSelected=';
                   $Str .= &Apache::lonnet::escape('student_assessment');
                   $Str .= '&sort='.&Apache::lonnet::escape($ENV{'form.sort'});
                   $Str .= '&SelectedStudent=';
                   $Str .= &Apache::lonnet::escape($sname).'">';
                   $Str .= $student->{$field}.'&nbsp';
                   $Str .= '</a>';
               } else {
                   $Str .= $student->{$field};
               }
               $Str .= '</td>';
           }
           $Str .= "</tr>\n";
       }
       $Str .= '</table></td></tr></table>'."\n";
       #
       $r->print($Str);
     $r->rflush();      $r->rflush();
       #
       return;
 }  }
   
   ##############################################
   ##############################################
   sub CreateMainMenu {
       my ($status,$reports,$current)=@_;
       #
       my $Str = '';
       #
       $Str  = '<input type="hidden" name="reportSelected" value="'.$current.'">';
   #    $Str .= '<table border="0"><tbody><tr>'."\n";
   #    $Str .= '<td align="center"><b>Report:</b></td>'."\n";
   #    $Str .= '<td align="center">';
   #    $Str .= '<select name="reportSelected" '.
   #        'onchange="document.Statistics.submit()">'."\n";
   #    foreach (sort(keys(%$reports))) {
   #        $Str .= '<option value="'.$_.'"';
   #        if($current eq $_) {
   #            $Str .= ' selected';
   #        }
   #        $Str .= '>'.$reports->{$_}.'</option>'."\n";
   #    }
   #    $Str .= '</select></td>'."\n";
   #    #
   #    $Str .= '<td>'.('&nbsp;'x30).'</td>';
   #    $Str .= '<td align="center">'.
   #        '<input type="submit" name="ClearCache" value="Clear Caches" />'.
   #            "</td>\n";
   #    $Str .= '</tr></tbody></table>'."\n";
   #    $Str .= '<hr>'."\n";
       #
       return $Str;
   }
   
 # ================================================================ Main Handler  ##############################################
   ##############################################
 sub handler {  sub handler {
     $r=shift;      my $r=shift;
       my $c = $r->connection();
     if (&Apache::lonnet::allowed('vgr',$ENV{'request.course.id'})) {      #
 # ------------------------------------------- Set document type for header only      # Check for overloading
  if ($r->header_only) {      my $loaderror=&Apache::lonnet::overloaderror($r);
     if ($ENV{'browser.mathml'}) {      if ($loaderror) { return $loaderror; }
  $r->content_type('text/xml');      $loaderror=
     }          &Apache::lonnet::overloaderror($r,
     else {           $ENV{'course.'.$ENV{'request.course.id'}.'.home'});
  $r->content_type('text/html');      if ($loaderror) { return $loaderror; }
     }      #
     $r->send_http_header;      # Check for access
     return OK;      if (! &Apache::lonnet::allowed('vgr',$ENV{'request.course.id'})) {
  }      
  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'}=          $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";
           if (! &Apache::lonnet::allowed('vgr',
         return HTTP_NOT_ACCEPTABLE;                         $ENV{'request.course.id'}.'/'.$ENV{'request.course.sec'})) {
               $ENV{'user.error.msg'}=
                   $r->uri.":vgr:0:0:Cannot view grades with given role";
               return HTTP_NOT_ACCEPTABLE;
           }
     }      }
       #
       # Set document type for header only
       if($r->header_only) {
           if ($ENV{'browser.mathml'}) {
               $r->content_type('text/xml');
           } else {
               $r->content_type('text/html');
           }
           &Apache::loncommon::no_cache($r);
           $r->send_http_header;
           return OK;
       }
       #
       # Send the header
       $r->content_type('text/html');
       $r->send_http_header;
       #
       # Extract form elements from query string
       &Apache::loncommon::get_unprocessed_cgi($ENV{'QUERY_STRING'},
                                               ['sort','reportSelected',
                                                'SelectedStudent']);
       if (! exists($ENV{'form.reportSelected'})) {
           $ENV{'form.reportSelected'} = 'student_assessment';
       }
       #
       # Give the LON-CAPA page header
       $r->print(&Apache::lonhtmlcommon::Title('Course Statistics and Charts'));
       $r->rflush();
       #
       if (! &Apache::lonmysql::verify_sql_connection()) {
           my $serveradmin = $r->dir_config('lonAdmEMail');
           $r->print(<<END);
   <h2><font color="Red">Unable to connect to database!</font></h2>
   <p>
   Please notify the server administrator <b>$serveradmin</b>.
   </p><p>
   Course Statistics and Charts cannot be retrieved until the database is
   restarted.  Your data is intact but cannot be displayed at this time.
   </p>
   </body>
   </html>
   END
           return;
       }
       #
       # Clean out the caches
       if (exists($ENV{'form.ClearCache'})) {
           &Apache::loncoursedata::delete_caches($ENV{'requres.course.id'});
       }
       #
       # Set up the statistics and chart environment
       &PrepareClasslist();
       &PrepareCourseData($r);
       #
       # Begin form output
       $r->print('<form name="Statistics" ');
       $r->print('method="post" action="/adm/statistics">');
       #
       # Print main menu
       my %reports = ('classlist'          => 'Class list',
                      'problem_statistics' => 'Problem Statistics',
                      'student_assessment' => 'Problem Status Chart',
   #                   'percentage'         => 'Correct-problems Plot',
   #                   'option_response'    => 'Option Response Analysis',
   #                   'activitylog'        => 'Activity Log',
                      );
       $r->print(&CreateMainMenu($ENV{'form.status'},
                                 \%reports,$ENV{'form.reportSelected'}));
       $r->rflush();
       #
       my $GoToPage = $ENV{'form.reportSelected'};
       if($GoToPage eq 'activitylog') {
   #        &Apache::lonproblemstatistics::Activity();
       } elsif($GoToPage eq 'problem_statistics') {
           &Apache::lonproblemstatistics::BuildProblemStatisticsPage($r,$c);
       } elsif($GoToPage eq 'option_response') {
   #        &Apache::lonproblemanalysis::BuildProblemAnalysisPage($r,$c);
       } elsif($GoToPage eq 'student_assessment') {
           &Apache::lonstudentassessment::BuildStudentAssessmentPage($r,$c);
       } elsif($GoToPage eq 'DoDiffGraph' || $GoToPage eq 'PercentWrongGraph') {
   #        &Apache::lonproblemstatistics::BuildGraphicChart($r,$c);
       } elsif($GoToPage eq 'Correct-problems Plot') {
   # &Apache::lonpercentage::BuildPercentageGraph($r,$c);
       }
       #
       $r->print("</form>\n");
       $r->print("</body>\n</html>\n");
       $r->rflush();
       #
       return OK;
 }  }
   
 1;  1;
 __END__  
   
   #######################################################
   #######################################################
   
   =pod
   
   =back
   
   =cut
   
   #######################################################
   #######################################################
   
   __END__
   
Removed from v.1.6  
changed lines
  Added in v.1.78

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