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

Diff for /loncom/interface/statistics/lonstudentassessment.pm between versions 1.18 and 1.71

version 1.18, 2002/11/08 22:16:47 version 1.71, 2003/10/21 21:23:53
Line 1 Line 1
 # The LearningOnline Network with CAPA  # The LearningOnline Network with CAPA
 # (Publication Handler  
 #  #
 # $Id$  # $Id$
 #  #
Line 25 Line 24
 # http://www.lon-capa.org/  # http://www.lon-capa.org/
 #  #
 # (Navigate problems for statistical reports  # (Navigate problems for statistical reports
 # YEAR=2001  
 # 5/5,7/9,7/25/1,8/11,9/13,9/26,10/5,10/9,10/22,10/26 Behrouz Minaei  
 # 11/1,11/4,11/16,12/14,12/16,12/18,12/20,12/31 Behrouz Minaei  
 # YEAR=2002  
 # 1/22,2/1,2/6,2/25,3/2,3/6,3/17,3/21,3/22,3/26,4/7,5/6 Behrouz Minaei  
 # 5/12,5/14,5/15,5/19,5/26,7/16  Behrouz Minaei  
 #  #
 ###  #######################################################
   #######################################################
   
 package Apache::lonstudentassessment;   =pod
   
   =head1 NAME
   
   lonstudentassessment
   
   =head1 SYNOPSIS
   
   Presents assessment data about a student or a group of students.
   
   =head1 Subroutines
   
   =over 4 
   
   =cut
   
   #######################################################
   #######################################################
   
   package Apache::lonstudentassessment;
   
 use strict;  use strict;
   use Apache::lonstatistics;
 use Apache::lonhtmlcommon;  use Apache::lonhtmlcommon;
 use Apache::loncoursedata;  use Apache::loncoursedata;
 use GDBM_File;  use Apache::lonnet; # for logging porpoises
   use Spreadsheet::WriteExcel;
   
   #######################################################
   #######################################################
   =pod
   
   =item Package Variables
   
   =over 4
   
   =item $Statistics Hash ref to store student data.  Indexed by symb,
         contains hashes with keys 'score' and 'max'.
   
   =cut
   
   #######################################################
   #######################################################
   
   my $Statistics;
   
 #my $jr;  #######################################################
   #######################################################
   
   =pod
   
   =item $show_links 'yes' or 'no' for linking to student performance data
   
   =item $output_mode 'html', 'excel', or 'csv' for output mode
   
   =item $show 'all', 'totals', or 'scores' determines how much data is output
   
   =item $data  determines what performance data is shown
   
   =item $datadescription A short description of the output data selected.
   
   =item $base 'tries' or 'scores' determines the base of the performance shown
   
   =item $single_student_mode evaluates to true if we are showing only one
   student.
   
   =cut
   
   #######################################################
   #######################################################
   my $show_links;
   my $output_mode;
   my $data;
   my $base;
   my $datadescription;
   my $single_student_mode;
   
   #######################################################
   #######################################################
   # End of package variable declarations
   
   =pod
   
   =back
   
   =cut
   
   #######################################################
   #######################################################
   
   =pod
   
   =item &BuildStudentAssessmentPage()
   
   Inputs: 
   
   =over 4
   
   =item $r Apache Request
   
   =item $c Apache Connection 
   
   =back
   
   =cut
   
   #######################################################
   #######################################################
 sub BuildStudentAssessmentPage {  sub BuildStudentAssessmentPage {
     my ($cacheDB,$students,$courseID,$formName,$headings,$spacing,      my ($r,$c)=@_;
         $studentInformation,$r,$c)=@_;  
 #    $jr = $r;      undef($Statistics);
     my %cache;      undef($show_links);
     unless(tie(%cache,'GDBM_File',$cacheDB,&GDBM_READER(),0640)) {      undef($output_mode);
         $r->print('<html><body>Unable to tie database.</body></html>');      undef($data);
       undef($base);
       undef($datadescription);
       undef($single_student_mode);
   
       $single_student_mode = 0;
       $single_student_mode = 1 if ($ENV{'form.SelectedStudent'});
       if ($ENV{'form.selectstudent'}) {
           &Apache::lonstatistics::DisplayClasslist($r);
         return;          return;
     }      }
       #
     # Remove students who don't have the proper section.      # Print out the HTML headers for the interface
     my @sectionsSelected = split(':',$cache{'sectionsSelected'});      #    This also parses the output mode selector
     for(my $studentIndex=((scalar @$students)-1); $studentIndex>=0;      #    This step must *always* be done.
         $studentIndex--) {      $r->print(&CreateInterface());
         my $value = $cache{$students->[$studentIndex].':section'};      $r->print('<input type="hidden" name="notfirstrun" value="true" />');
         my $found = 0;      $r->print('<input type="hidden" name="sort" value="'.
         foreach (@sectionsSelected) {                $ENV{'form.sort'}.'" />');
             if($_ eq 'none') {      $r->rflush();
                 if($value eq '' || !defined($value) || $value eq ' ') {      #
                     $found = 1;      if (! exists($ENV{'form.notfirstrun'}) && ! $single_student_mode) {
                     last;          return;
                 }      }
             } else {      #
                 if($value eq $_) {      my $initialize     = \&html_initialize;
                     $found = 1;      my $output_student = \&html_outputstudent;
                     last;      my $finish         = \&html_finish;
                 }      #
             }      if ($output_mode eq 'excel') {
         }          $initialize     = \&excel_initialize;
         if($found == 0) {          $output_student = \&excel_outputstudent;
             splice(@$students, $studentIndex, 1);          $finish         = \&excel_finish;
       } elsif ($output_mode eq 'csv') {
           $initialize     = \&csv_initialize;
           $output_student = \&csv_outputstudent;
           $finish         = \&csv_finish;
       }
       #
       if($c->aborted()) {  return ; }
       #
       # Determine which students we want to look at
       my @Students;
       if ($single_student_mode) {
           @Students = (&Apache::lonstatistics::current_student());
           $r->print(&next_and_previous_buttons());
           $r->rflush();
       } else {
           @Students = @Apache::lonstatistics::Students;
       }
       #
       # Perform generic initialization tasks
       #       Since we use lonnet::EXT to retrieve problem weights,
       #       to ensure current data we must clear the caches out.
       #       This makes sure that parameter changes at the student level
       #       are immediately reflected in the chart.
       &Apache::lonnet::clear_EXT_cache_status();
       #
       # Clean out loncoursedata's package data, just to be safe.
       &Apache::loncoursedata::clear_internal_caches();
       #
       # Call the initialize routine selected above
       $initialize->($r);
       foreach my $student (@Students) {
           if($c->aborted()) { 
               $finish->($r);
               return ; 
         }          }
           # Call the output_student routine selected above
           $output_student->($r,$student);
     }      }
     my ($infoHeadings, $infoKeys, $sequenceHeadings, $sequenceKeys,      # Call the "finish" routine selected above
         $doNotShow) =       $finish->($r);
         &ShouldShowColumns(\%cache, $headings, $studentInformation);      #
       return;
     my $selectedName = &FindSelectedStudent(\%cache,   }
                                             $cache{'StudentAssessmentStudent'},  
                                             $students);  
     $r->print(&CreateInterface(\%cache, $selectedName, $students, $formName,  
                                $doNotShow));  
     $r->rflush();  
   
   #######################################################
   #######################################################
   sub next_and_previous_buttons {
     my $Str = '';      my $Str = '';
     if($selectedName eq 'No Student Selected') {      $Str .= '<input type="hidden" name="SelectedStudent" value="'.
  $Str .= '<h3><font color=blue>WARNING: ';          $ENV{'form.SelectedStudent'}.'" />';
         $Str .= 'Please select a student</font></h3>';      #
         $r->print($Str);      # Build the previous student link
         return;      my $previous = &Apache::lonstatistics::previous_student();
       my $previousbutton = '';
       if (defined($previous)) {
           my $sname = $previous->{'username'}.':'.$previous->{'domain'};
           $previousbutton .= '<input type="button" value="'.
               'Previous Student ('.
               $previous->{'username'}.'@'.$previous->{'domain'}.')'.
               '" onclick="document.Statistics.SelectedStudent.value='.
               "'".$sname."'".';'.
               'document.Statistics.submit();" />';
       } else {
           $previousbutton .= '<input type="button" value="'.
               'Previous student (none)'.'" />';
       }
       #
       # Build the next student link
       my $next = &Apache::lonstatistics::next_student();
       my $nextbutton = '';
       if (defined($next)) {
           my $sname = $next->{'username'}.':'.$next->{'domain'};
           $nextbutton .= '<input type="button" value="'.
               'Next Student ('.
               $next->{'username'}.'@'.$next->{'domain'}.')'.
               '" onclick="document.Statistics.SelectedStudent.value='.
               "'".$sname."'".';'.
               'document.Statistics.submit();" />';
       } else {
           $nextbutton .= '<input type="button" value="'.
               'Next student (none)'.'" />';
     }      }
       #
       # Build the 'all students' button
       my $all = '';
       $all .= '<input type="button" value="All Students" '.
               '" onclick="document.Statistics.SelectedStudent.value='.
               "''".';'.'document.Statistics.submit();" />';
       $Str .= $previousbutton.('&nbsp;'x5).$all.('&nbsp;'x5).$nextbutton;
       return $Str;
   }
   
     $r->print(&CreateTableHeadings(\%cache, $spacing, $infoKeys, $infoHeadings,  #######################################################
                                    $sequenceKeys, $sequenceHeadings));  #######################################################
     untie(%cache);  
     if($c->aborted()) {  return $Str; }  sub get_student_fields_to_show {
       my @to_show = @Apache::lonstatistics::SelectedStudentData;
     my $selected=0;      foreach (@to_show) {
     $r->print('<pre>'."\n");          if ($_ eq 'all') {
     foreach (@$students) {              @to_show = @Apache::lonstatistics::StudentDataOrder;
         if($c->aborted()) { return $Str; }              last;
         next if ($_ ne $selectedName &&  
                  $selectedName ne 'All Students');  
         $selected = 1;  
   
         my @who = ($_);  
         next if(&Apache::loncoursedata::DownloadStudentCourseData(\@who, 'true',  
                                                              $cacheDB, 'true',  
                                                              'false', $courseID,  
                                                              $r, $c) ne 'OK');  
         next if($c->aborted());  
   
         if(tie(%cache,'GDBM_File',$cacheDB,&GDBM_READER(),0640)) {  
             my @before=();  
             my @after=();  
             my @updateColumn=();  
             my $foundUpdate = 0;  
             foreach(@$infoKeys) {  
                 if(/updateTime/) {  
                     $foundUpdate=1;  
                     push(@updateColumn, $_);  
                     next;  
                 }  
                 if($foundUpdate) {  
                     push(@after, $_);  
                 } else {  
                     push(@before, $_);  
                 }  
             }  
             my $displayString = 'DISPLAYDATA'.$spacing;  
             $r->print(&Apache::lonhtmlcommon::FormatStudentInformation(  
                                                          \%cache, $_,  
                                                          \@before,  
                                                          $displayString,  
                                                          'preformatted'));  
   
             if($foundUpdate) {  
                 $displayString = '';  
                 $displayString .= '<a href="/adm/statistics?reportSelected=';  
                 $displayString .= &Apache::lonnet::escape('Student Assessment');  
                 $displayString .= '&download='.$_.'">';  
                 $displayString .= 'DISPLAYDATA</a>'.$spacing;  
                 $r->print(&Apache::lonhtmlcommon::FormatStudentInformation(  
                                                                    \%cache, $_,  
                                                                    \@updateColumn,  
                                                                    $displayString,  
                                                                    'preformatted'));  
             }  
   
             $displayString = 'DISPLAYDATA'.$spacing;  
             $r->print(&Apache::lonhtmlcommon::FormatStudentInformation(  
                                                          \%cache, $_,  
                                                          \@after,  
                                                          $displayString,  
                                                          'preformatted'));  
             $r->print(&StudentReport(\%cache, $_, $spacing, $sequenceKeys));  
             $r->print("\n");  
             $r->rflush();  
             untie(%cache);  
         }          }
     }      }
       return @to_show;
   }
   
   #######################################################
   #######################################################
   
 #    $r->print("AverageTtal");  =pod
     $r->print(&StudentAverageTotal(\%cache, $spacing, $sequenceKeys));  
     $r->print("\n");  
     $r->rflush();  
     untie(%cache);  
   
   =item &CreateInterface()
   
     $r->print('</pre>'."\n");  Called by &BuildStudentAssessmentPage to create the top part of the
     if($selected == 0) {  page which displays the chart.
  $Str .= '<h3><font color=blue>WARNING: ';  
         $Str .= 'Please select a student</font></h3>';  
         $r->print($Str);  
     }  
   
     return;  Inputs: None
 }  
   
 #---- Student Assessment Web Page --------------------------------------------  Returns:  A string containing the HTML for the headers and top table for 
   the chart page.
   
 sub CreateInterface {  =cut
     my($cache,$selectedName,$students,$formName,$doNotShow)=@_;  
   
   #######################################################
   #######################################################
   sub CreateInterface {
     my $Str = '';      my $Str = '';
     $Str .= &CreateLegend();  #    $Str .= &CreateLegend();
     $Str .= '<table><tr><td>'."\n";      $Str .= '<table cellspacing="5">'."\n";
     $Str .= '<input type="submit" name="PreviousStudent" ';      $Str .= '<tr>';
     $Str .= 'value="Previous Student" />'."\n";      $Str .= '<td align="center"><b>Sections</b></td>';
     $Str .= '&nbsp&nbsp&nbsp'."\n";      $Str .= '<td align="center"><b>Student Data</b></td>';
     $Str .= &Apache::lonhtmlcommon::StudentOptions($cache, $students,      $Str .= '<td align="center"><b>Enrollment Status</b></td>';
                                                    $selectedName,       $Str .= '<td align="center"><b>Sequences and Folders</b></td>';
                                                    'StudentAssessment',       $Str .= '<td align="center"><b>Output Format</b>'.
                                                    $formName);          &Apache::loncommon::help_open_topic("Chart_Output_Formats").
     $Str .= "\n".'&nbsp&nbsp&nbsp'."\n";          '</td>';
     $Str .= '<input type="submit" name="NextStudent" ';      $Str .= '<td align="center"><b>Output Data</b>'.
     $Str .= 'value="Next Student" />'."\n";          &Apache::loncommon::help_open_topic("Chart_Output_Data").
     $Str .= '</td></tr></table>'."\n";          '</td>';
     $Str .= '<table cellspacing="5"><tr>'."\n";      $Str .= '</tr>'."\n";
     $Str .= '<td align="center"><b>Select Sections</b>'."\n";      #
     $Str .= '</td>'."\n";  
     $Str .= '<td align="center"><b>Select column to view:</b></td>'."\n";  
     $Str .= '<td></td></tr>'."\n";  
   
     $Str .= '<tr><td align="center">'."\n";      $Str .= '<tr><td align="center">'."\n";
     my @sections = split(':',$cache->{'sectionList'});      $Str .= &Apache::lonstatistics::SectionSelect('Section','multiple',5);
     my @selectedSections = split(':',$cache->{'sectionsSelected'});  
     $Str .= &Apache::lonhtmlcommon::MultipleSectionSelect(\@sections,  
                                                           \@selectedSections,  
                                                           'Statistics');  
     $Str .= '</td><td align="center">';      $Str .= '</td><td align="center">';
     $Str .= &CreateColumnSelectionBox($doNotShow);      my $only_seq_with_assessments = sub { 
           my $s=shift;
           if ($s->{'num_assess'} < 1) { 
               return 0;
           } else { 
               return 1;
           }
       };
       $Str .= &Apache::lonstatistics::StudentDataSelect('StudentData','multiple',
                                                         5,undef);
     $Str .= '</td><td>'."\n";      $Str .= '</td><td>'."\n";
     $Str .= '<input type="submit" name="DefaultColumns" ';      $Str .= &Apache::lonhtmlcommon::StatusOptions(undef,undef,5);
     $Str .= 'value="Default Column Display" />'."\n";  
     $Str .= '</td><td>'."\n";      $Str .= '</td><td>'."\n";
     $Str .= '<input type="submit" name="displaymode" ';      $Str .= &Apache::lonstatistics::MapSelect('Maps','multiple,all',5,
     if (! exists($ENV{'form.displaymode'}) ||                                                $only_seq_with_assessments);
         lc($ENV{'form.displaymode'}) eq 'display with links') {      $Str .= '</td><td>'."\n";
         $Str .= 'value="Display without links" />';      $Str .= &CreateAndParseOutputSelector();
         # Set the current value, in case it is undefined      $Str .= '</td><td>'."\n";
         $ENV{'form.displaymode'} = 'Display with links';       $Str .= &CreateAndParseOutputDataSelector();
     } else {      $Str .= '</td></tr>'."\n";
         $Str .= 'value="Display with links" />';      $Str .= '</table>'."\n";
     }      $Str .= '<input type="submit" value="Generate Chart" />';
     $Str .= "\n";      $Str .= '&nbsp;'x5;
     $Str .= '</td></tr></table>'."\n";      $Str .= '<input type="submit" name="selectstudent" '.
                                     'value="Select One Student" />';
       $Str .= '&nbsp;'x5;
       $Str .= '<input type="submit" name="ClearCache" value="Clear Caches" />';
       $Str .= '&nbsp;'x5;
       $Str .= '<br />';
     return $Str;      return $Str;
 }  }
   
 sub CreateTableHeadings {  #######################################################
     my($cache,$spacing,$infoKeys,$infoHeadings,$sequenceKeys,  #######################################################
        $sequenceHeadings)=@_;  
   
     my $Str = '';  =pod
     $Str .= '<table border="0" cellpadding="0" cellspacing="0">'."\n";  
   
     $Str .= '<tr>'."\n";  =item &CreateAndParseOutputSelector()
     $Str .= &CreateColumnSelectors($infoHeadings, $sequenceHeadings,  
                                    $sequenceKeys);  =cut
     $Str .= '<td></td></tr>'."\n";  
   
     $Str .= '<tr>'."\n";  
     my $displayString = '<td align="left"><pre><a href="/adm/statistics?';  
     $displayString .= 'sort=LINKDATA">DISPLAYDATA</a>FORMATTING';  
     $displayString .= $spacing.'</pre></td>'."\n";  
     $Str .= &Apache::lonhtmlcommon::CreateHeadings($cache,  
                                                    $infoKeys,  
                                                    $infoHeadings,  
                                                    $displayString,  
                                                    'preformatted');  
   
     $displayString  = '<td align="left"><pre>DISPLAYDATAFORMATTING'.$spacing;  
     $displayString .= '</pre></td>'."\n";  
     $Str .= &Apache::lonhtmlcommon::CreateHeadings($cache,  
                                                    $sequenceKeys,  
                                                    $sequenceHeadings,  
                                                    $displayString,  
                                                    'preformatted');  
   
     $Str .= '<td><pre>Total Solved/Total Problems</pre></td>';  #######################################################
     $Str .= '</tr></table>'."\n";  #######################################################
   my @OutputOptions = 
       ({ name  => 'HTML, with links',
          value => 'html, with links',
          description => 'Output HTML with each symbol linked to the problem '.
      'which generated it.',
          mode => 'html',
          show_links => 'yes',
          },
        { name  => 'HTML, with all links',
          value => 'html, with all links',
          description => 'Output HTML with each symbol linked to the problem '.
      'which generated it.  '.
              'This includes links for unattempted problems.',
          mode => 'html',
          show_links => 'all',
          },
        { name  => 'HTML, without links',
          value => 'html, without links',
          description => 'Output HTML.  By not including links, the size of the'.
      ' web page is greatly reduced.  If your browser crashes on the '.
      'full display, try this.',
          mode => 'html',
          show_links => 'no',
              },
        { name  => 'Excel',
          value => 'excel',
          description => 'Output an Excel file (compatable with Excel 95).',
          mode => 'excel',
          show_links => 'no',
      },
        { name  => 'CSV',
          value => 'csv',
          description => 'Output a comma seperated values file suitable for '.
              'import into a spreadsheet program.  Using this method as opposed '.
              'to Excel output allows you to organize your data before importing'.
              ' it into a spreadsheet program.',
          mode => 'csv',
          show_links => 'no',
              },
        );
   
   sub OutputDescriptions {
       my $Str = '';
       $Str .= "<h2>Output Formats</h2>\n";
       $Str .= "<dl>\n";
       foreach my $outputmode (@OutputOptions) {
    $Str .="    <dt>".$outputmode->{'name'}."</dt>\n";
    $Str .="        <dd>".$outputmode->{'description'}."</dd>\n";
       }
       $Str .= "</dl>\n";
     return $Str;      return $Str;
 }  }
   
 =pod  sub CreateAndParseOutputSelector {
       my $Str = '';
       my $elementname = 'chartoutputmode';
       #
       # Format for output options is 'mode, restrictions';
       my $selected = 'html, without links';
       if (exists($ENV{'form.'.$elementname})) {
           if (ref($ENV{'form.'.$elementname} eq 'ARRAY')) {
               $selected = $ENV{'form.'.$elementname}->[0];
           } else {
               $selected = $ENV{'form.'.$elementname};
           }
       }
       #
       # Set package variables describing output mode
       $show_links  = 'no';
       $output_mode = 'html';
       foreach my $option (@OutputOptions) {
           next if ($option->{'value'} ne $selected);
           $output_mode = $option->{'mode'};
           $show_links  = $option->{'show_links'};
       }
   
       #
       # Build the form element
       $Str = qq/<select size="5" name="$elementname">/;
       foreach my $option (@OutputOptions) {
           $Str .= "\n".'    <option value="'.$option->{'value'}.'"';
           $Str .= " selected " if ($option->{'value'} eq $selected);
           $Str .= ">".$option->{'name'}."<\/option>";
       }
       $Str .= "\n</select>";
       return $Str;
   }
   
 =item &FormatStudentData()  ##
   ## Data selector stuff
   ##
   my @OutputDataOptions =
       (
        { name  => 'Scores',
          base  => 'scores',
          value => 'sum and total',
          shortdesc => 'Total Score and Maximum Possible for each '.
              'Sequence or Folder',
          longdesc => 'The score of each student as well as the '.
              ' maximum possible on each Sequence or Folder.',
          },
        { name  => 'Scores Per Problem',
          base  => 'scores',
          value => 'scores',
          shortdesc => 'Score on each Problem Part',
          longdesc =>'The students score on each problem part, computed as'.
              'the part weight * part awarded',
          },
   #     { name  => 'Scores Sum',
   #       base  => 'scores',
   #       value => 'sum only',
   #       shortdesc => 'Sum of Scores on each Problem Part',
   #       longdesc =>'The total of the scores of the student on each problem'.
   #           ' part in the sequences or folders selected.',
   #       },
   #     { name  => 'Scores Summary Table Only',
   #       base  => 'scores',
   #       value => 'final table scores',
   #       shortdesc => 'Summary of Scores',
   #       longdesc  => 'The average score on each sequence or folder for the '.
   #           'selected students.',
   #       },
        { name  =>'Tries',
          base  =>'tries',
          value => 'tries',
          shortdesc => 'Number of Tries before success on each Problem Part',
          longdesc =>'The number of tries before success on each problem part.',
          },
        { name  =>'Parts Correct',
          base  =>'tries',
          value => 'parts correct total',
          shortdesc => 'Number of Problem Parts completed successfully.',
          longdesc => 'The Number of Problem Parts completed successfully and '.
              'the maximum possible for each student',
          },
   #     { name  =>'Parts Correct',
   #       base  =>'tries',
   #       value => 'parts correct',
   #       shortdesc => 'Number of Problem Parts completed successfully.',
   #       longdesc => 'The Number of Problem Parts completed successfully'.
   #           ' on each sequence or folder.',
   #       },
   #     { name  => 'Parts Summary Table Only',
   #       base  => 'tries',
   #       value => 'final table parts',
   #       shortdesc => 'Summary of Parts Correct',
   #       longdesc  => 'A summary table of the average number of problem parts '.
   #           'students were able to get correct on each sequence.',
   #       },
        );
   
 First, FormatStudentInformation is called and prefixes the course information.  sub HTMLifyOutputDataDescriptions {
 This function produces a formatted string of the student\'s course information.      my $Str = '';
 Each column of data represents all the problems for a given sequence.  For      $Str .= "<h2>Output Data</h2>\n";
 valid grade data, a link is created for that problem to a submission record      $Str .= "<dl>\n";
 for that problem.      foreach my $option (@OutputDataOptions) {
           $Str .= '    <dt>'.$option->{'name'}.'</dt>';
           $Str .= '<dd>'.$option->{'longdesc'}.'</dd>'."\n";
       }
       $Str .= "</dl>\n";
       return $Str;
   }
   
 =over 4  sub CreateAndParseOutputDataSelector {
       my $Str = '';
       my $elementname = 'chartoutputdata';
       #
       my $selected = 'scores';
       if (exists($ENV{'form.'.$elementname})) {
           if (ref($ENV{'form.'.$elementname} eq 'ARRAY')) {
               $selected = $ENV{'form.'.$elementname}->[0];
           } else {
               $selected = $ENV{'form.'.$elementname};
           }
       }
       #
       $data = 'scores';
       foreach my $option (@OutputDataOptions) {
           if ($option->{'value'} eq $selected) {
               $data = $option->{'value'};
               $base = $option->{'base'};
               $datadescription = $option->{'shortdesc'};
           }
       }
       #
       # Build the form element
       $Str = qq/<select size="5" name="$elementname">/;
       foreach my $option (@OutputDataOptions) {
           $Str .= "\n".'    <option value="'.$option->{'value'}.'"';
           $Str .= " selected " if ($option->{'value'} eq $data);
           $Str .= ">".$option->{'name'}."<\/option>";
       }
       $Str .= "\n</select>";
       return $Str;
   
   }
   
 Input: $name, $studentInformation, $ChartDB  #######################################################
   #######################################################
   
 $name: The name and domain of the current student in name:domain format  =pod
   
 $studentInformation: A pointer to an array holding the names used to   =head2 HTML output routines
 remove data from the hash.  They represent   
 the name of the data to be removed.  
   
 $ChartDB: The name of the cached data database which will be tied to that   =item &html_initialize($r)
 database.  
   
 Output: $Str  Create labels for the columns of student data to show.
   
 $Str: Formatted string that is an entire row of the chart.  It is a   =item &html_outputstudent($r,$student)
 concatenation of student information and student course information.  
   
 =back  Return a line of the chart for a student.
   
   =item &html_finish($r)
   
 =cut  =cut
   
 sub StudentReport {  #######################################################
     my ($cache,$name,$spacing,$showSequences)=@_;  #######################################################
     my ($username,$domain)=split(':',$name);  {
       my $padding;
       my $count;
   
       my $nodata_count; # The number of students for which there is no data
       my %prog_state;   # progress state used by loncommon PrgWin routines
   
   sub html_initialize {
       my ($r) = @_;
       #
       $padding = ' 'x3;
       $count = 0;
       $nodata_count = 0;
       undef(%prog_state);
       #
       $r->print("<h3>".$ENV{'course.'.$ENV{'request.course.id'}.'.description'}.
                 "&nbsp;&nbsp;".localtime(time)."</h3>");
   
       if ($data !~ /^final table/) {
           $r->print("<h3>".$datadescription."</h3>");        
       }
       #
       # Set up progress window for 'final table' display only
       if ($data =~ /^final table/) {
           my $studentcount = scalar(@Apache::lonstatistics::Students); 
           %prog_state=&Apache::lonhtmlcommon::Create_PrgWin
               ($r,'Summary Table Status',
                'Summary Table Compilation Progress', $studentcount);
       }
       my $Str = "<pre>\n";
       # First, the @StudentData fields need to be listed
       my @to_show = &get_student_fields_to_show();
       foreach my $field (@to_show) {
           my $title=$Apache::lonstatistics::StudentData{$field}->{'title'};
           my $base =$Apache::lonstatistics::StudentData{$field}->{'base_width'};
           my $width=$Apache::lonstatistics::StudentData{$field}->{'width'};
           $Str .= $title.' 'x($width-$base).$padding;
       }
       # Now the selected sequences need to be listed
       foreach my $sequence (&Apache::lonstatistics::Sequences_with_Assess()){
           my $title = $sequence->{'title'};
           my $base  = $sequence->{'base_width'};
           my $width = $sequence->{'width'};
           $Str .= $title.' 'x($width-$base).$padding;
       }
       $Str .= "total</pre>\n";
       $Str .= "<pre>";
       #
       # Check for suppression of output
       if ($data =~ /^final table/) {
           $Str = '';
       }
       $r->print($Str);
       $r->rflush();
       return;
   }
   
   sub html_outputstudent {
       my ($r,$student) = @_;
     my $Str = '';      my $Str = '';
     if(defined($cache->{$name.':error'})) {      #
         return $Str;      if($count++ % 5 == 0 && $count > 0 && $data !~ /^final table/) {
           $r->print("</pre><pre>");
       }
       # First, the @StudentData fields need to be listed
       my @to_show = &get_student_fields_to_show();
       foreach my $field (@to_show) {
           my $title=$student->{$field};
           my $base = length($title);
           my $width=$Apache::lonstatistics::StudentData{$field}->{'width'};
           $Str .= $title.' 'x($width-$base).$padding;
       }
       # Get ALL the students data
       my %StudentsData;
       my @tmp = &Apache::loncoursedata::get_current_state
           ($student->{'username'},$student->{'domain'},undef,
            $ENV{'request.course.id'});
       if ((scalar @tmp > 0) && ($tmp[0] !~ /^error:/)) {
           %StudentsData = @tmp;
       }
       if (scalar(@tmp) < 1) {
           $nodata_count++;
           return if ($data =~ /^final table/);
           $Str .= '<font color="blue">No Course Data</font>'."\n";
           $r->print($Str);
           $r->rflush();
           return;
     }      }
     if($cache->{$name.':error'} =~ /course/) {      #
         $Str .= '<b><font color="blue">No course data for student </font>';      # By sequence build up the data
         $Str .= '<font color="red">'.$username.'.</font></b><br>';      my $studentstats;
         return $Str;      my $PerformanceStr = '';
     }      foreach my $seq (&Apache::lonstatistics::Sequences_with_Assess()) {
           my ($performance,$performance_length,$score,$seq_max,$rawdata);
     my $hasVersion = 'false';          if ($base eq 'tries') {
     my $hasFinalData = 'false';              ($performance,$performance_length,$score,$seq_max,$rawdata) =
     foreach my $sequence (@$showSequences) {                  &StudentTriesOnSequence($student,\%StudentsData,
         my $hasData = 'false';                                          $seq,$show_links);
         my $characterCount=0;          } else {
         foreach my $problemID (split(':', $cache->{$sequence.':problems'})) {              ($performance,$performance_length,$score,$seq_max,$rawdata) =
             my $problem = $cache->{$problemID.':problem'};                  &StudentPerformanceOnSequence($student,\%StudentsData,
             # All grades (except for versionless parts) are displayed as links                                                $seq,$show_links);
             # to their submission record.  Loop through all the parts for the  
             # current problem in the correct order and prepare the output links  
             foreach(split(/\:/,$cache->{$sequence.':'.$problemID.  
                                         ':parts'})) {  
                 if($cache->{$name.':'.$problemID.':NoVersion'} eq 'true' ||  
                    $cache->{$name.':'.$problemID.':'.$_.':code'} eq ' ' ||  
                    $cache->{$name.':'.$problemID.':'.$_.':code'} eq '') {  
                     $Str .= ' ';  
                     $characterCount++;  
                     next;  
                 }  
                 $hasVersion = 'true';  
                 $hasData = 'true';  
                 if (lc($ENV{'form.displaymode'}) ne 'display without links') {  
                     $Str .= '<a href="/adm/grades?symb=';  
                     $Str .= &Apache::lonnet::escape($problem);  
                     $Str .= '&student='.$username.'&domain='.$domain;  
                     $Str .= '&command=submission">';   
                 }  
                 my $code = $cache->{$name.':'.$problemID.':'.$_.':code'};  
                 my $tries = $cache->{$name.':'.$problemID.':'.$_.':tries'};  
                 if($code eq '*' && $tries < 10 && $tries ne '') {  
                     $code = $tries;  
                 }  
                 $Str .= $code;  
                 if (lc($ENV{'form.displaymode'}) ne 'display without links') {  
                     $Str .= '</a>';  
                 }  
                 $characterCount++;  
             }  
         }          }
           my $ratio = sprintf("%3d",$score).'/'.sprintf("%3d",$seq_max);
         # Output the number of correct answers for the current sequence.          #
         # This part takes up 6 character slots, but is formated right          if ($data eq 'sum and total' || $data eq 'parts correct total') {
         # justified.              $performance  = $ratio;
         my $spacesNeeded=$cache->{$sequence.':columnWidth'}-$characterCount;              $performance .= ' 'x($seq->{'width'}-length($ratio));
         $spacesNeeded -= 3;          } elsif ($data eq 'sum only' || $data eq 'parts correct') {
         $Str .= (' 'x$spacesNeeded);              $performance  = $score;
               $performance .= ' 'x($seq->{'width'}-length($score));
 #        my $outputProblemsCorrect = sprintf("%3d", $cache->{$name.':'.$sequence.  
 #    ':problemsCorrect'});  
   
  my $outputProblemsCorrect = sprintf("%2d/%2d", $cache->{$name.':'.$sequence.  
                                             ':problemsCorrect'},  
                                             $characterCount);  
         if($hasData eq 'true') {  
             $Str .= '<font color="#007700">'.$outputProblemsCorrect.'</font>';  
             $hasFinalData = 'true';  
         } else {          } else {
             $Str .= '<font color="#007700">     </font>';              # Pad with extra spaces
               $performance .= ' 'x($seq->{'width'}-$performance_length-
                                    length($ratio)
                                    ).$ratio;
         }          }
         $Str .= $spacing;          #
           $Str .= $performance.$padding;
           #
           $studentstats->{$seq->{'symb'}}->{'score'}= $score;
           $studentstats->{$seq->{'symb'}}->{'max'}  = $seq_max;
       }
       #
       # Total it up and store the statistics info.
       my ($score,$max) = (0,0);
       while (my ($symb,$seq_stats) = each (%{$studentstats})) {
           $Statistics->{$symb}->{'score'} += $seq_stats->{'score'};
           if ($Statistics->{$symb}->{'max'} < $seq_stats->{'max'}) {
               $Statistics->{$symb}->{'max'} = $seq_stats->{'max'};
           }
           $score += $seq_stats->{'score'};
           $max   += $seq_stats->{'max'};
     }      }
       $Str .= ' '.' 'x(length($max)-length($score)).$score.'/'.$max;
       $Str .= " \n";
       #
       # Check for suppressed output and update the progress window if so...
       if ($data =~ /^final table/) {
           $Str = '';
           &Apache::lonhtmlcommon::Increment_PrgWin($r,\%prog_state,
                                                    'last student');
       }
       #
       $r->print($Str);
       #
       $r->rflush();
       return;
   }    
   
     # Output the total correct problems over the total number of problems.  sub html_finish {
     # I don't like this type of formatting, but it is a solution.  Need      my ($r) = @_;
     # a way to dynamically determine the space requirements.      #
     my $outputProblemsSolved = sprintf("%4d", $cache->{$name.':problemsSolved'});      # Check for suppressed output and close the progress window if so
     my $outputTotalProblems  = sprintf("%4d", $cache->{$name.':totalProblems'});      if ($data =~ /^final table/) {
     if($hasFinalData eq 'true') {          &Apache::lonhtmlcommon::Close_PrgWin($r,\%prog_state);
         $Str .= '<font color="#000088">'.$outputProblemsSolved.  
     ' / '.$outputTotalProblems.'</font>';  
     } else {      } else {
         $Str .= '<font color="#000088">           </font>';          $r->print("</pre>\n"); 
     }      }
       if ($single_student_mode) {
     if($hasVersion eq 'false') {          $r->print(&SingleStudentTotal());
         $Str = '<b><font color="blue">No course data.</font></b>';      } else {
           $r->print(&StudentAverageTotal());
     }      }
       $r->rflush();
     return $Str;      return;
 }  }
   
   
 sub StudentAverageTotal {  sub StudentAverageTotal {
           my $Str = "<h3>Summary Tables</h3>\n";
     return "";      my $num_students = scalar(@Apache::lonstatistics::Students);
       my $total_ave = 0;
     my ($cache,$name,$spacing,$showSequences)=@_;      my $total_max = 0;
     my $username = $name;      $Str .= '<table border=2 cellspacing="1">'."\n";
     my $Str = '';      $Str .= "<tr><th>Title</th><th>Average</th><th>Maximum</th></tr>\n";
     my $hasVersion = 'false';      foreach my $seq (&Apache::lonstatistics::Sequences_with_Assess()) {
     my $hasFinalData = 'false';          my $ave;
     foreach my $sequence (@$showSequences) {          if ($num_students > $nodata_count) {
         my $hasData = 'false';              $ave = int(100*($Statistics->{$seq->{'symb'}}->{'score'}/
         my $characterCount=0;                              ($num_students-$nodata_count)))/100;
         foreach my $problemID (split(':', $cache->{$sequence.':problems'})) {          } else {
             my $problem = $cache->{$problemID.':problem'};              $ave = 0;
             # All grades (except for versionless parts) are displayed as links  
             # to their submission record.  Loop through all the parts for the  
             # current problem in the correct order and prepare the output links  
             foreach(split(/\:/,$cache->{$sequence.':'.$problemID.  
                                         ':parts'})) {  
                 if($cache->{$name.':'.$problemID.':NoVersion'} eq 'true' ||  
                    $cache->{$name.':'.$problemID.':'.$_.':code'} eq ' ' ||  
                    $cache->{$name.':'.$problemID.':'.$_.':code'} eq '') {  
                     $Str .= ' ';  
                     $characterCount++;  
                     next;  
                 }  
                 $hasVersion = 'true';  
                 $hasData = 'true';  
                 $Str .= '<a href="/adm/grades?symb=';  
                 $Str .= &Apache::lonnet::escape($problem);  
                 $Str .= '&student= Average &domain= Total';  
                 $Str .= '&command=submission">';  
                 my $code = $cache->{$name.':'.$problemID.':'.$_.':code'};  
                 my $tries = $cache->{$name.':'.$problemID.':'.$_.':tries'};  
                 if($code eq '*' && $tries < 10 && $tries ne '') {  
                     $code = $tries;  
                 }  
                 $Str .= $code;  
                 $Str .= '</a>';  
                 $characterCount++;  
             }  
         }          }
           $total_ave += $ave;
           my $max = $Statistics->{$seq->{'symb'}}->{'max'};
           $total_max += $max;
           if ($ave == 0) {
               $ave = "0.00";
           }
           $ave .= '&nbsp;';
           $max .= '&nbsp;&nbsp;&nbsp;';
           $Str .= '<tr><td>'.$seq->{'title'}.'</td>'.
               '<td align="right">'.$ave.'</td>'.
                   '<td align="right">'.$max.'</td></tr>'."\n";
       }
       $total_ave = int(100*$total_ave)/100; # only two digit
       $Str .= "</table>\n";
       $Str .= '<table border=2 cellspacing="1">'."\n";
       $Str .= '<tr><th>Number of Students</th><th>Average</th>'.
           "<th>Maximum</th></tr>\n";
       $Str .= '<tr><td>'.($num_students-$nodata_count).'</td>'.
           '<td>'.$total_ave.'</td><td>'.$total_max.'</td>';
       $Str .= "</table>\n";
       return $Str;
   }
   
         # Output the number of correct answers for the current sequence.  sub SingleStudentTotal {
         # This part takes up 6 character slots, but is formated right      my $student = &Apache::lonstatistics::current_student();
         # justified.      my $Str = "<h3>Summary table for ".$student->{'fullname'}." ".
         my $spacesNeeded=$cache->{$sequence.':columnWidth'}-$characterCount;          $student->{'username'}.'@'.$student->{'domain'}."</h3>\n";
         $spacesNeeded -= 3;      $Str .= '<table border=2 cellspacing="1">'."\n";
         $Str .= (' 'x$spacesNeeded);      $Str .= 
           "<tr><th>Sequence or Folder</th><th>Score</th><th>Maximum</th></tr>\n";
 #        my $outputProblemsCorrect = sprintf("%3d", $cache->{$name.':'.$sequence.      my $total = 0;
 #    ':problemsCorrect'});      my $total_max = 0;
       foreach my $seq (&Apache::lonstatistics::Sequences_with_Assess()) {
  my $outputProblemsCorrect = sprintf("%2d/%2d", $cache->{$name.':'.$sequence.          my $value = $Statistics->{$seq->{'symb'}}->{'score'};
                                             ':problemsCorrect'},          my $max = $Statistics->{$seq->{'symb'}}->{'max'};
                                             $characterCount);          $Str .= '<tr><td>'.$seq->{'title'}.'</td>'.
         if($hasData eq 'true') {              '<td align="right">'.$value.'</td>'.
             $Str .= '<font color="#007700">'.$outputProblemsCorrect.'</font>';                  '<td align="right">'.$max.'</td></tr>'."\n";
             $hasFinalData = 'true';          $total += $value;
         } else {          $total_max +=$max;
             $Str .= '<font color="#007700">     </font>';      }
         }      $Str .= '<tr><td><b>Total</b></td>'.
         $Str .= $spacing;          '<td align="right">'.$total.'</td>'.
     }          '<td align="right">'.$total_max."</td></tr>\n";
       $Str .= "</table>\n";
     # Output the total correct problems over the total number of problems.  
     # I don't like this type of formatting, but it is a solution.  Need  
     # a way to dynamically determine the space requirements.  
     my $outputProblemsSolved = sprintf("%4d", $cache->{$name.':problemsSolved'});  
     my $outputTotalProblems  = sprintf("%4d", $cache->{$name.':totalProblems'});  
     if($hasFinalData eq 'true') {  
         $Str .= '<font color="#000088">'.$outputProblemsSolved.  
     ' / '.$outputTotalProblems.'</font>';  
     } else {  
         $Str .= '<font color="#000088">           </font>';  
     }  
   
     if($hasVersion eq 'false') {  
         $Str = '<b><font color="blue">No course data.</font></b>';  
     }  
   
     return $Str;      return $Str;
 }  }
   
   }
   
   #######################################################
   #######################################################
   
 =pod  =pod
   
 =item &CreateLegend()  =head2 EXCEL subroutines
   
 This function returns a formatted string containing the legend for the  =item &excel_initialize($r)
 chart.  The legend describes the symbols used to represent grades for  
 problems.  
   
 =cut  =item &excel_outputstudent($r,$student)
   
 sub CreateLegend {  =item &excel_finish($r)
     my $Str = "<p><pre>".  
               "   1  correct by student in 1 try\n".  
               "   7  correct by student in 7 tries\n".  
               "   *  correct by student in more than 9 tries\n".  
       "   +  correct by override\n".  
               "   -  incorrect by override\n".  
       "   .  incorrect attempted\n".  
       "   #  ungraded attempted\n".  
               "      not attempted (blank field)\n".  
       "   x  excused".  
               "</pre><p>";  
     return $Str;  
 }  
   
 =pod  =cut
   
 =item &CreateColumnSelectionBox()  #######################################################
   #######################################################
   {
   
   my $excel_sheet;
   my $excel_workbook;
   
   my $filename;
   my $rows_output;
   my $cols_output;
   
   my %prog_state; # progress window state
   my $request_aborted;
   
   sub excel_initialize {
       my ($r) = @_;
       #
       undef ($excel_sheet);
       undef ($excel_workbook);
       undef ($filename);
       undef ($rows_output);
       undef ($cols_output);
       undef (%prog_state);
       undef ($request_aborted);
       #
       my $total_columns = scalar(&get_student_fields_to_show());
       foreach my $seq (&Apache::lonstatistics::Sequences_with_Assess()) {
           # Add 2 because we need a 'sum' and 'total' column for each
           $total_columns += $seq->{'num_assess_parts'}+2;
       }
       if ($data eq 'tries' && $total_columns > 255) {
           $r->print(<<END);
   <h2>Unable to Complete Request</h2>
   <p>
   LON-CAPA is unable to produce your Excel spreadsheet because your selections
   will result in more than 255 columns.  Excel allows only 255 columns in a
   spreadsheet.
   </p><p>
   You may consider reducing the number of <b>Sequences or Folders</b> you
   have selected.  
   </p><p>
   LON-CAPA can produce <b>CSV</b> files of this data or Excel files of the
   summary data (<b>Parts Correct</b> or <b>Parts Correct & Totals</b>).
   </p>
   END
          $request_aborted = 1;
       }
       if ($data eq 'scores' && $total_columns > 255) {
           $r->print(<<END);
   <h2>Unable to Complete Request</h2>
   <p>
   LON-CAPA is unable to produce your Excel spreadsheet because your selections
   will result in more than 255 columns.  Excel allows only 255 columns in a
   spreadsheet.
   </p><p>
   You may consider reducing the number of <b>Sequences or Folders</b> you
   have selected.  
   </p><p>
   LON-CAPA can produce <b>CSV</b> files of this data or Excel files of the
   summary data (<b>Scores Sum</b> or <b>Scores Sum & Totals</b>).
   </p>
   END
          $request_aborted = 1;
       }
       if ($data =~ /^final table/) {
           $r->print(<<END);
   <h2>Unable to Complete Request</h2>
   <p>
   The <b>Summary Table (Scores)</b> option is not available for non-HTML output.
   </p>
   END
          $request_aborted = 1;
       }
       return if ($request_aborted);
       #
       $filename = '/prtspool/'.
           $ENV{'user.name'}.'_'.$ENV{'user.domain'}.'_'.
               time.'_'.rand(1000000000).'.xls';
       #
       $excel_workbook = undef;
       $excel_sheet = undef;
       #
       $rows_output = 0;
       $cols_output = 0;
       #
       # Create sheet
       $excel_workbook = Spreadsheet::WriteExcel->new('/home/httpd'.$filename);
       #
       # Check for errors
       if (! defined($excel_workbook)) {
           $r->log_error("Error creating excel spreadsheet $filename: $!");
           $r->print("Problems creating new Excel file.  ".
                     "This error has been logged.  ".
                     "Please alert your LON-CAPA administrator");
           return ;
       }
       #
       # The excel spreadsheet stores temporary data in files, then put them
       # together.  If needed we should be able to disable this (memory only).
       # The temporary directory must be specified before calling 'addworksheet'.
       # File::Temp is used to determine the temporary directory.
       $excel_workbook->set_tempdir($Apache::lonnet::tmpdir);
       #
       # Add a worksheet
       my $sheetname = $ENV{'course.'.$ENV{'request.course.id'}.'.description'};
       $sheetname = &Apache::loncommon::clean_excel_name($sheetname);
       $excel_sheet = $excel_workbook->addworksheet($sheetname);
       #
       # Put the course description in the header
       $excel_sheet->write($rows_output,$cols_output++,
                      $ENV{'course.'.$ENV{'request.course.id'}.'.description'});
       $cols_output += 3;
       #
       # Put a description of the sections listed
       my $sectionstring = '';
       my @Sections = @Apache::lonstatistics::SelectedSections;
       if (scalar(@Sections) > 1) {
           if (scalar(@Sections) > 2) {
               my $last = pop(@Sections);
               $sectionstring = "Sections ".join(', ',@Sections).', and '.$last;
           } else {
               $sectionstring = "Sections ".join(' and ',@Sections);
           }
       } else {
           if ($Sections[0] eq 'all') {
               $sectionstring = "All sections";
           } else {
               $sectionstring = "Section ".$Sections[0];
           }
       }
       $excel_sheet->write($rows_output,$cols_output++,$sectionstring);
       $cols_output += scalar(@Sections);
       #
       # Put the date in there too
       $excel_sheet->write($rows_output++,$cols_output++,
                           'Compiled on '.localtime(time));
       #
       $cols_output = 0;
       $excel_sheet->write($rows_output++,$cols_output++,$datadescription);
       #
       if ($data eq 'tries' || $data eq 'scores') {
           $rows_output++;
       }
       #
       # Add the student headers
       $cols_output = 0;
       foreach my $field (&get_student_fields_to_show()) {
           $excel_sheet->write($rows_output,$cols_output++,$field);
       }
       my $row_offset = 0;
       if ($data eq 'tries' || $data eq 'scores') {
           $row_offset = -1;
       }
       #
       # Add the remaining column headers
       foreach my $seq (&Apache::lonstatistics::Sequences_with_Assess()) {
           $excel_sheet->write($rows_output+$row_offset,
                               $cols_output,$seq->{'title'});
           if ($data eq 'tries' || $data eq 'scores') {
               foreach my $res (@{$seq->{'contents'}}) {
                   next if ($res->{'type'} ne 'assessment');
                   if (scalar(@{$res->{'parts'}}) > 1) {
                       foreach my $part (@{$res->{'parts'}}) {
                           $excel_sheet->write($rows_output,
                                               $cols_output++,
                                               $res->{'title'}.' part '.$part);
                       }
                   } else {
                       $excel_sheet->write($rows_output,
                                           $cols_output++,
                                           $res->{'title'});
                   }
               }
               $excel_sheet->write($rows_output,$cols_output++,'score');
               $excel_sheet->write($rows_output,$cols_output++,'maximum');
           } elsif ($data eq 'sum and total' || $data eq 'parts correct total') {
               $excel_sheet->write($rows_output+1,$cols_output,'score');
               $excel_sheet->write($rows_output+1,$cols_output+1,'maximum');
               $cols_output += 2;
           } else {
               $cols_output++;
           }
       }
       #
       # Bookkeeping
       if ($data eq 'sum and total' || $data eq 'parts correct total') {
           $rows_output += 2;
       } else {
           $rows_output += 1;
       }
       #
       # Output a row for MAX
       $cols_output = 0;
       foreach my $field (&get_student_fields_to_show()) {
           if ($field eq 'username' || $field eq 'fullname' || 
               $field eq 'id') {
               $excel_sheet->write($rows_output,$cols_output++,'Maximum');
           } else {
               $excel_sheet->write($rows_output,$cols_output++,'');
           }
       }
       #
       # Add the maximums for each sequence or assessment
       foreach my $seq (&Apache::lonstatistics::Sequences_with_Assess()) {
           my $weight;
           my $max = 0;
           foreach my $resource (@{$seq->{'contents'}}) {
               next if ($resource->{'type'} ne 'assessment');
               foreach my $part (@{$resource->{'parts'}}) {
                   $weight = 1;
                   if ($base eq 'scores') {
                       $weight = &Apache::lonnet::EXT
                           ('resource.'.$part.'.weight',$resource->{'symb'},
                            undef,undef,undef);
                       if (!defined($weight) || ($weight eq '')) { 
                           $weight=1;
                       }
                   }
                   if ($data eq 'scores') {
                       $excel_sheet->write($rows_output,$cols_output++,$weight);
                   } elsif ($data eq 'tries') {
                       $excel_sheet->write($rows_output,$cols_output++,'');
                   }
                   $max += $weight;
               }
           } 
           if (! ($data eq 'sum only' || $data eq 'parts correct')) {
               $excel_sheet->write($rows_output,$cols_output++,'');
           }
           $excel_sheet->write($rows_output,$cols_output++,$max);
       }
       $rows_output++;
       #
       # Let the user know what we are doing
       my $studentcount = scalar(@Apache::lonstatistics::Students); 
       $r->print("<h1>Compiling Excel spreadsheet for ".
                 $studentcount.' student');
       $r->print('s') if ($studentcount > 1);
       $r->print("</h1>\n");
       $r->rflush();
       #
       # Initialize progress window
       %prog_state=&Apache::lonhtmlcommon::Create_PrgWin
           ($r,'Excel File Compilation Status',
            'Excel File Compilation Progress', $studentcount);
       #
       &Apache::lonhtmlcommon::Update_PrgWin($r,\%prog_state,
                                             'Processing first student');
       return;
   }
   
 If there are columns not being displayed then this selection box is created  sub excel_outputstudent {
 with a list of those columns.  When selections are made and the page      my ($r,$student) = @_;
 refreshed, the columns will be removed from this box and the column is      return if ($request_aborted);
 put back in the chart.  If there is no columns to select, no row is added      return if (! defined($excel_sheet));
 to the interface table.      $cols_output=0;
       #
       # Write out student data
       my @to_show = &get_student_fields_to_show();
       foreach my $field (@to_show) {
           $excel_sheet->write($rows_output,$cols_output++,$student->{$field});
       }
       #
       # Get student assessment data
       my %StudentsData;
       my @tmp = &Apache::loncoursedata::get_current_state($student->{'username'},
                                                           $student->{'domain'},
                                                           undef,
                                                      $ENV{'request.course.id'});
       if ((scalar @tmp > 0) && ($tmp[0] !~ /^error:/)) {
           %StudentsData = @tmp;
       }
       #
       # Write out sequence scores and totals data
       foreach my $seq (&Apache::lonstatistics::Sequences_with_Assess()) {
           my ($performance,$performance_length,$score,$seq_max,$rawdata);
           if ($base eq 'tries') {
               ($performance,$performance_length,$score,$seq_max,$rawdata) =
                   &StudentTriesOnSequence($student,\%StudentsData,
                                           $seq,'no');
           } else {
               ($performance,$performance_length,$score,$seq_max,$rawdata) =
                   &StudentPerformanceOnSequence($student,\%StudentsData,
                                                 $seq,'no');
           }
           if ($data eq 'tries' || $data eq 'scores') {
               foreach my $value (@$rawdata) {
                   $excel_sheet->write($rows_output,$cols_output++,$value);
               }
               $excel_sheet->write($rows_output,$cols_output++,$score);
               $excel_sheet->write($rows_output,$cols_output++,$seq_max);
           } elsif ($data eq 'sum and total' || $data eq 'sum only' || 
               $data eq 'parts correct' || $data eq 'parts correct total') {
               $excel_sheet->write($rows_output,$cols_output++,$score);
           }
           if ($data eq 'sum and total' || $data eq 'parts correct total') {
               $excel_sheet->write($rows_output,$cols_output++,$seq_max);
           }
       }
       #
       # Bookkeeping
       $rows_output++; 
       $cols_output=0;
       #
       # Update the progress window
       &Apache::lonhtmlcommon::Increment_PrgWin($r,\%prog_state,'last student');
       return;
   }
   
 =over 4  sub excel_finish {
 Input: $CacheData, $headings      my ($r) = @_;
       return if ($request_aborted);
       return if (! defined($excel_sheet));
       #
       # Write the excel file
       $excel_workbook->close();
       my $c = $r->connection();
       #
       return if($c->aborted());
       #
       # Close the progress window
       &Apache::lonhtmlcommon::Close_PrgWin($r,\%prog_state);
       #
       # Tell the user where to get their excel file
       $r->print('<br />'.
                 '<a href="'.$filename.'">Your Excel spreadsheet.</a>'."\n");
       $r->rflush();
       return;
   }
   
   }
   #######################################################
   #######################################################
   
 $CacheData: A pointer to a hash tied to the cached data  =pod
   
 $headings:  An array of the names of the columns for the student information.  =head2 CSV output routines
 They are used for displaying which columns are missing.  
   
 Output: $notThere  =item &csv_initialize($r)
   
 $notThere: The string contains one row of a table.  The first column has the  =item &csv_outputstudent($r,$student)
 name of the selection box.  The second contains the selection box  
 which has a size of four.  
   
 =back  =item &csv_finish($r)
   
 =cut  =cut
   
 sub CreateColumnSelectionBox {  #######################################################
     my ($doNotShow)=@_;  #######################################################
   {
     my $notThere = '';  
     $notThere .= '<select name="ReselectColumns" size="4" ';  my $outputfile;
     $notThere .= 'multiple="true">'."\n";  my $filename;
   my $request_aborted;
   my %prog_state; # progress window state
   
   sub csv_initialize{
       my ($r) = @_;
       # 
       # Clean up
       undef($outputfile);
       undef($filename);
       undef($request_aborted);
       undef(%prog_state);
       #
       # Deal with unimplemented requests
       $request_aborted = undef;
       if ($data =~ /final table/) {
           $r->print(<<END);
   <h2>Unable to Complete Request</h2>
   <p>
   The <b>Summary Table (Scores)</b> option is not available for non-HTML output.
   </p>
   END
          $request_aborted = 1;
       }
       return if ($request_aborted);
   
       #
       # Open a file
       $filename = '/prtspool/'.
           $ENV{'user.name'}.'_'.$ENV{'user.domain'}.'_'.
               time.'_'.rand(1000000000).'.csv';
       unless ($outputfile = Apache::File->new('>/home/httpd'.$filename)) {
           $r->log_error("Couldn't open $filename for output $!");
           $r->print("Problems occured in writing the csv file.  ".
                     "This error has been logged.  ".
                     "Please alert your LON-CAPA administrator.");
           $outputfile = undef;
       }
       #
       # Datestamp
       my $description = $ENV{'course.'.$ENV{'request.course.id'}.'.description'};
       print $outputfile '"'.&Apache::loncommon::csv_translate($description).'",'.
           '"'.&Apache::loncommon::csv_translate(scalar(localtime(time))).'"'.
               "\n";
       #
       # Print out the headings
       my $Str = '';
       my $Str2 = undef;
       foreach my $field (&get_student_fields_to_show()) {
           if ($data eq 'sum only') {
               $Str .= '"'.&Apache::loncommon::csv_translate($field).'",';
           } elsif ($data eq 'sum and total' || $data eq 'parts correct total') {
               $Str .= '"",'; # first row empty on the student fields
               $Str2 .= '"'.&Apache::loncommon::csv_translate($field).'",';
           } elsif ($data eq 'scores' || $data eq 'tries' || 
                    $data eq 'parts correct') {
               $Str  .= '"",';
               $Str2 .= '"'.&Apache::loncommon::csv_translate($field).'",';
           }
       }
       foreach my $seq (&Apache::lonstatistics::Sequences_with_Assess()) {
           if ($data eq 'sum only' || $data eq 'parts correct') {
               $Str .= '"'.&Apache::loncommon::csv_translate($seq->{'title'}).
                   '",';
           } elsif ($data eq 'sum and total' || $data eq 'parts correct total') {
               $Str  .= '"'.&Apache::loncommon::csv_translate($seq->{'title'}).
                   '","",';
               $Str2 .= '"score","total possible",';
           } elsif ($data eq 'scores' || $data eq 'tries') {
               $Str  .= '"'.&Apache::loncommon::csv_translate($seq->{'title'}).
                   '",';
               $Str .= '"",'x($seq->{'num_assess_parts'}-1+2);
               foreach my $res (@{$seq->{'contents'}}) {
                   next if ($res->{'type'} ne 'assessment');
                   foreach my $part (@{$res->{'parts'}}) {
                       $Str2 .= '"'.&Apache::loncommon::csv_translate($res->{'title'}.', Part '.$part).'",';
                   }
               }
               $Str2 .= '"score","total possible",';
           }
       }
       chop($Str);
       $Str .= "\n";
       print $outputfile $Str;
       if (defined($Str2)) {
           chop($Str2);
           $Str2 .= "\n";
           print $outputfile $Str2;
       }
       #
       # Initialize progress window
       my $studentcount = scalar(@Apache::lonstatistics::Students);
       %prog_state=&Apache::lonhtmlcommon::Create_PrgWin
           ($r,'CSV File Compilation Status',
            'CSV File Compilation Progress', $studentcount);
       return;
   }
   
     for(my $index=0; $index<$doNotShow->{'count'}; $index++) {  sub csv_outputstudent {
         my $name = $doNotShow->{$index.':name'};      my ($r,$student) = @_;
         $notThere .= '<option value="';      return if ($request_aborted);
         $notThere .= $doNotShow->{$index.':id'}.'">';      return if (! defined($outputfile));
         $notThere .= $name.'</option>'."\n";      my $Str = '';
       #
       # Output student fields
       my @to_show = &get_student_fields_to_show();
       foreach my $field (@to_show) {
           $Str .= '"'.&Apache::loncommon::csv_translate($student->{$field}).'",';
       }
       #
       # Get student assessment data
       my %StudentsData;
       my @tmp = &Apache::loncoursedata::get_current_state($student->{'username'},
                                                           $student->{'domain'},
                                                           undef,
                                                      $ENV{'request.course.id'});
       if ((scalar @tmp > 0) && ($tmp[0] !~ /^error:/)) {
           %StudentsData = @tmp;
       }
       #
       # Output performance data
       foreach my $seq (&Apache::lonstatistics::Sequences_with_Assess()) {
           my ($performance,$performance_length,$score,$seq_max,$rawdata);
           if ($base eq 'tries') {
               ($performance,$performance_length,$score,$seq_max,$rawdata) =
                   &StudentTriesOnSequence($student,\%StudentsData,
                                           $seq,'no');
           } else {
               ($performance,$performance_length,$score,$seq_max,$rawdata) =
                   &StudentPerformanceOnSequence($student,\%StudentsData,
                                                 $seq,'no');
           }
           if ($data eq 'sum only' || $data eq 'parts correct') {
               $Str .= '"'.$score.'",';
           } elsif ($data eq 'sum and total' || $data eq 'parts correct total') {
               $Str  .= '"'.$score.'","'.$seq_max.'",';
           } elsif ($data eq 'scores' || $data eq 'tries') {
               $Str .= '"'.join('","',(@$rawdata,$score,$seq_max)).'",';
           }
     }      }
       chop($Str);
       $Str .= "\n";
       print $outputfile $Str;
       #
       # Update the progress window
       &Apache::lonhtmlcommon::Increment_PrgWin($r,\%prog_state,'last student');
       return;
   }
   
     $notThere .= '</select>';  sub csv_finish {
       my ($r) = @_;
       return if ($request_aborted);
       return if (! defined($outputfile));
       close($outputfile);
       #
       my $c = $r->connection();
       return if ($c->aborted());
       #
       # Close the progress window
       &Apache::lonhtmlcommon::Close_PrgWin($r,\%prog_state);
       #
       # Tell the user where to get their csv file
       $r->print('<br />'.
                 '<a href="'.$filename.'">Your csv file.</a>'."\n");
       $r->rflush();
       return;
       
   }
   
     return $notThere;  
 }  }
   
   #######################################################
   #######################################################
   
 =pod  =pod
   
 =item &CreateColumnSelectors()  =item &StudentTriesOnSequence()
   
 This function generates the checkboxes above the column headings.  The  Inputs:
 column will be removed if the checkbox is unchecked.  
   
 =over 4  =over 4
   
 Input: $CacheData, $headings  =item $student
   
 $CacheData: A pointer to a hash tied to the cached data  
   
 $headings:  An array of the names of the columns for the student   =item $studentdata Hash ref to all student data
 information.  They are used to know what are the student information columns  
   
 Output: $present  =item $seq Hash ref, the sequence we are working on
   
 $present: The string contains the first row of a table.  Each column contains  =item $links if defined we will output links to each resource.
 a checkbox which is left justified.  Currently left justification is used  
 for consistency of location over the column in which it presides.  
   
 =back  =back
   
 =cut  =cut
   
 sub CreateColumnSelectors {  #######################################################
     my ($infoHeadings, $sequenceHeadings, $sequenceKeys)=@_;  #######################################################
   sub StudentTriesOnSequence {
     my $present = '';      my ($student,$studentdata,$seq,$links) = @_;
     for(my $index=0; $index<(scalar @$infoHeadings); $index++) {      $links = 'no' if (! defined($links));
         $present .= '<td align="left">';      my $Str = '';
         $present .= '<input type="checkbox" checked="on" ';      my ($sum,$max) = (0,0);
         $present .= 'name="HeadingColumn'.$infoHeadings->[$index].'" />';      my $performance_length = 0;
         $present .= '</td>'."\n";      my @TriesData = ();
     }      my $tries;
       foreach my $resource (@{$seq->{'contents'}}) {
     for(my $index=0; $index<(scalar @$sequenceHeadings); $index++) {          next if ($resource->{'type'} ne 'assessment');
         $present .= '<td align="left">';          my $resource_data = $studentdata->{$resource->{'symb'}};
         $present .= '<input type="checkbox" checked="on" ';          my $value = '';
         $present .= 'name="SequenceColumn'.$sequenceKeys->[$index].'" />';          foreach my $partnum (@{$resource->{'parts'}}) {
         $present .= '</td>'."\n";              $tries = undef;
     }              $max++;
               $performance_length++;
     return $present;              my $symbol = ' '; # default to space
 }              #
               if (exists($resource_data->{'resource.'.$partnum.'.solved'})) {
 #---- END Student Assessment Web Page ----------------------------------------                  my $status = $resource_data->{'resource.'.$partnum.'.solved'};
                   if ($status eq 'correct_by_override') {
 #---- Student Assessment Worker Functions ------------------------------------                      $symbol = '+';
                       $sum++;
 sub FindSelectedStudent {                  } elsif ($status eq 'incorrect_by_override') {
     my($cache, $selectedName, $students)=@_;                      $symbol = '-';
                   } elsif ($status eq 'ungraded_attempted') {
     if($selectedName eq 'All Students' ||                      $symbol = '#';
        $selectedName eq 'No Student Selected') {                  } elsif ($status eq 'incorrect_attempted')  {
         return $selectedName;                      $symbol = '.';
     }                  } elsif ($status eq 'excused') {
                       $symbol = 'x';
     for(my $index=0; $index<(scalar @$students); $index++) {                      $max--;
         my $fullname = $cache->{$students->[$index].':fullname'};                  } elsif (($status eq 'correct_by_scantron' ||
         if($fullname eq $selectedName) {                            $status eq 'correct_by_student') &&
             if($cache->{'StudentAssessmentMove'} eq 'next') {                      exists($resource_data->{'resource.'.$partnum.'.tries'})){
                 if($index == ((scalar @$students) - 1)) {                      $tries = $resource_data->{'resource.'.$partnum.'.tries'};
                     $selectedName = $students->[0];                      if ($tries > 9) {
                     return $selectedName;                          $symbol = '*';
                       } elsif ($tries > 0) {
                           $symbol = $tries;
                       } else {
                           $symbol = ' ';
                       }
                       $sum++;
                   } elsif (exists($resource_data->{'resource.'.
                                                        $partnum.'.tries'})){
                       $symbol = '.';
                 } else {                  } else {
                     $selectedName = $students->[$index+1];                      $symbol = ' ';
                     return $selectedName;  
                 }                  }
             } elsif($cache->{'StudentAssessmentMove'} eq 'previous') {              } else {
                 if($index == 0) {                  # Unsolved.  Did they try?
                     $selectedName = $students->[-1];                  if (exists($resource_data->{'resource.'.$partnum.'.tries'})){
                     return $selectedName;                      $symbol = '.';
                 } else {                  } else {
                     $selectedName = $students->[$index-1];                      $symbol = ' ';
                     return $selectedName;  
                 }                  }
             } else {  
                 $selectedName = $students->[$index];  
                 return $selectedName;  
             }              }
             last;              #
               if (! defined($tries)) {
                   $tries = $symbol;
               }
               push (@TriesData,$tries);
               #
               if ( ($links eq 'yes' && $symbol ne ' ') ||
                    ($links eq 'all')) {
                   if (length($symbol) > 1) {
                       &Apache::lonnet::logthis('length of symbol "'.$symbol.'" > 1');
                   }
                   $symbol = '<a href="/adm/grades'.
                       '?symb='.&Apache::lonnet::escape($resource->{'symb'}).
                           '&student='.$student->{'username'}.
                               '&userdom='.$student->{'domain'}.
                                   '&command=submission">'.$symbol.'</a>';
               }
               $value .= $symbol;
         }          }
           $Str .= $value;
     }      }
       if ($seq->{'randompick'}) {
     return 'No Student Selected';          $max = $seq->{'randompick'};
       }
       return ($Str,$performance_length,$sum,$max,\@TriesData);
 }  }
   
   #######################################################
   #######################################################
   
 =pod  =pod
   
 =item &ShouldShowColumn()  =item &StudentPerformanceOnSequence()
   
 Determine if a specified column should be shown on the chart.  Inputs:
   
 =over 4  =over 4
   
 Input: $cache, $test  =item $student
   
 $cache: A pointer to the hash tied to the cached data  =item $studentdata Hash ref to all student data
   
 $test: The form name of the column (heading.$headingIndex) or   =item $seq Hash ref, the sequence we are working on
 (sequence.$sequenceIndex)  
   
 Output: 0 (false), 1 (true)  =item $links if defined we will output links to each resource.
   
 =back  =back
   
 =cut  =cut
   
 sub ShouldShowColumns {  #######################################################
     my ($cache,$headings,$cacheKey)=@_;  #######################################################
   sub StudentPerformanceOnSequence {
     my @infoKeys=();      my ($student,$studentdata,$seq,$links) = @_;
     my @infoHeadings=();      $links = 'no' if (! defined($links));
       my $Str = ''; # final result string
       my ($score,$max) = (0,0);
       my $performance_length = 0;
       my $symbol;
       my @ScoreData = ();
       my $partscore;
       foreach my $resource (@{$seq->{'contents'}}) {
           next if ($resource->{'type'} ne 'assessment');
           my $resource_data = $studentdata->{$resource->{'symb'}};
           foreach my $part (@{$resource->{'parts'}}) {
               $partscore = undef;
               my $weight = &Apache::lonnet::EXT('resource.'.$part.'.weight',
                                                 $resource->{'symb'},
                                                 $student->{'domain'},
                                                 $student->{'username'},
                                                 $student->{'section'});
               if (!defined($weight) || ($weight eq '')) { 
                   $weight=1;
               }
               #
               $max += $weight; # see the 'excused' branch below...
               $performance_length++; # one character per part
               $symbol = ' '; # default to space
               #
               my $awarded = 0;
               if (exists($resource_data->{'resource.'.$part.'.awarded'})) {
                   $awarded = $resource_data->{'resource.'.$part.'.awarded'};
                   $awarded = 0 if (! $awarded);
               }
               #
               $partscore = $weight*$awarded;
               $score += $partscore;
               $symbol = $partscore; 
               if (abs($symbol - sprintf("%.0f",$symbol)) < 0.001) {
                   $symbol = sprintf("%.0f",$symbol);
               }
               if (length($symbol) > 1) {
                   $symbol = '*';
               }
               if (exists($resource_data->{'resource.'.$part.'.solved'})) {
                   my $status = $resource_data->{'resource.'.$part.'.solved'};
                   if ($status eq 'excused') {
                       $symbol = 'x';
                       $max -= $weight; # Do not count 'excused' problems.
                   }
               } else {
                   # Unsolved.  Did they try?
                   if (exists($resource_data->{'resource.'.$part.'.tries'})){
                       $symbol = '.';
                   } else {
                       $symbol = ' ';
                   }
               }
               #
               if (! defined($partscore)) {
                   $partscore = $symbol;
               }
               push (@ScoreData,$partscore);
               #
               if ( ($links eq 'yes' && $symbol ne ' ') || ($links eq 'all')) {
                   $symbol = '<a href="/adm/grades'.
                       '?symb='.&Apache::lonnet::escape($resource->{'symb'}).
                       '&student='.$student->{'username'}.
                       '&userdom='.$student->{'domain'}.
                       '&command=submission">'.$symbol.'</a>';
               }
               $Str .= $symbol;
           }
       }
       return ($Str,$performance_length,$score,$max,\@ScoreData);
   }
   
     my @sequenceKeys=();  #######################################################
     my @sequenceHeadings=();  #######################################################
   
     my %doNotShow;  =pod
   
     my $index;  =item &CreateLegend()
     my $count = 0;  
     my $check = '';  
     for($index=0; $index < scalar @$headings; $index++) {  
         $check = 'HeadingColumn'.$headings->[$index];  
         if($cache->{'HeadingsFound'} =~ /$check/) {  
             push(@infoHeadings, $headings->[$index]);  
             push(@infoKeys, $cacheKey->[$index]);  
         } else {  
             $doNotShow{$count.':name'} = $headings->[$index];  
             $doNotShow{$count.':id'} = 'HeadingColumn'.$headings->[$index];  
             $count++;  
         }  
     }  
   
     foreach my $sequence (split(/\:/,$cache->{'orderedSequences'})) {  This function returns a formatted string containing the legend for the
         $check = 'SequenceColumn'.$sequence;  chart.  The legend describes the symbols used to represent grades for
         if($cache->{'SequencesFound'} eq 'All Sequences' ||   problems.
            $cache->{'SequencesFound'} =~ /$check/) {  
             push(@sequenceHeadings, $cache->{$sequence.':title'});  
             push(@sequenceKeys, $sequence);  
         } else {  
             $doNotShow{$count.':name'} = $cache->{$sequence.':title'};  
             $doNotShow{$count.':id'} = 'SequenceColumn'.$sequence;  
             $count++;  
         }  
     }  
   
     $doNotShow{'count'} = $count;  =cut
   
     return (\@infoHeadings, \@infoKeys, \@sequenceHeadings,   #######################################################
             \@sequenceKeys, \%doNotShow);  #######################################################
   sub CreateLegend {
       my $Str = "<p><pre>".
                 "   1  correct by student in 1 try\n".
                 "   7  correct by student in 7 tries\n".
                 "   *  correct by student in more than 9 tries\n".
         "   +  correct by hand grading or override\n".
                 "   -  incorrect by override\n".
         "   .  incorrect attempted\n".
         "   #  ungraded attempted\n".
                 "      not attempted (blank field)\n".
         "   x  excused".
                 "</pre><p>";
       return $Str;
 }  }
   
 #---- END Student Assessment Worker Functions --------------------------------  #######################################################
   #######################################################
   
   =pod 
   
   =back
   
   =cut
   
   #######################################################
   #######################################################
   
 1;  1;
   
 __END__  __END__
Removed from v.1.18  
changed lines
  Added in v.1.71

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