Annotation of loncom/interface/statistics/lonstudentassessment.pm, revision 1.35
1.1 stredwic 1: # The LearningOnline Network with CAPA
2: #
1.35 ! matthew 3: # $Id: lonstudentassessment.pm,v 1.34 2003/03/04 16:10:09 matthew Exp $
1.1 stredwic 4: #
5: # Copyright Michigan State University Board of Trustees
6: #
7: # This file is part of the LearningOnline Network with CAPA (LON-CAPA).
8: # LON-CAPA is free software; you can redistribute it and/or modify
9: # it under the terms of the GNU General Public License as published by
10: # the Free Software Foundation; either version 2 of the License, or
11: # (at your option) any later version.
12: #
13: # LON-CAPA is distributed in the hope that it will be useful,
14: # but WITHOUT ANY WARRANTY; without even the implied warranty of
15: # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16: # GNU General Public License for more details.
17: #
18: # You should have received a copy of the GNU General Public License
19: # along with LON-CAPA; if not, write to the Free Software
20: # Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
21: #
22: # /home/httpd/html/adm/gpl.txt
23: #
24: # http://www.lon-capa.org/
25: #
26: # (Navigate problems for statistical reports
1.28 matthew 27: #
28: #######################################################
29: #######################################################
30:
31: =pod
32:
33: =head1 NAME
34:
35: lonstudentassessment
36:
37: =head1 SYNOPSIS
38:
39: Presents assessment data about a student or a group of students.
40:
41: =head1 Subroutines
42:
43: =over 4
44:
45: =cut
46:
47: #######################################################
48: #######################################################
1.1 stredwic 49:
1.21 minaeibi 50: package Apache::lonstudentassessment;
1.1 stredwic 51:
52: use strict;
1.28 matthew 53: use Apache::lonstatistics;
1.1 stredwic 54: use Apache::lonhtmlcommon;
55: use Apache::loncoursedata;
1.28 matthew 56: use Apache::lonnet; # for logging porpoises
1.31 matthew 57: use Spreadsheet::WriteExcel;
58:
59: #######################################################
60: #######################################################
61: =pod
62:
63: =item Package Variables
64:
65: =over 4
66:
67: =item $Statistics Hash ref to store student data. Indexed by symb,
68: contains hashes with keys 'score' and 'max'.
69:
70: =cut
71:
72: #######################################################
73: #######################################################
1.1 stredwic 74:
1.30 matthew 75: my $Statistics;
76:
1.28 matthew 77: #######################################################
78: #######################################################
79:
80: =pod
81:
1.31 matthew 82: =item $show_links 'yes' or 'no' for linking to student performance data
83:
84: =item $output_mode 'html', 'excel', or 'csv' for output mode
85:
1.32 matthew 86: =item $show 'all', 'totals', or 'scores' determines how much data is output
1.31 matthew 87:
88: =cut
89:
90: #######################################################
91: #######################################################
92: my $show_links;
93: my $output_mode;
94: my $show;
1.28 matthew 95:
1.31 matthew 96: #######################################################
97: #######################################################
98: # End of package variable declarations
1.28 matthew 99:
1.31 matthew 100: =pod
1.28 matthew 101:
1.31 matthew 102: =back
1.28 matthew 103:
1.31 matthew 104: =cut
1.28 matthew 105:
1.31 matthew 106: #######################################################
107: #######################################################
1.28 matthew 108:
1.31 matthew 109: =pod
1.28 matthew 110:
1.31 matthew 111: =item &BuildStudentAssessmentPage()
1.28 matthew 112:
1.31 matthew 113: Inputs:
1.4 stredwic 114:
1.31 matthew 115: =over 4
1.28 matthew 116:
117: =item $r Apache Request
118:
119: =item $c Apache Connection
120:
121: =back
122:
123: =cut
124:
125: #######################################################
126: #######################################################
1.1 stredwic 127: sub BuildStudentAssessmentPage {
1.30 matthew 128: my ($r,$c)=@_;
129: undef($Statistics);
130: #
1.31 matthew 131: # Print out the HTML headers for the interface
132: # This also parses the output mode selector
133: # This step must always be done.
1.30 matthew 134: $r->print(&CreateInterface());
1.31 matthew 135: $r->print('<input type="hidden" name="notfirstrun" value="true" />');
1.7 stredwic 136: $r->rflush();
1.31 matthew 137: if (! exists($ENV{'form.notfirstrun'})) {
138: $r->print(<<ENDMSG);
139: <p>
140: <font size="+1">
141: Please make your selections in the boxes above and hit
142: the button marked "Update Display".
143: </font>
144: </p>
145: ENDMSG
1.33 matthew 146: # $r->print(&OutputDescriptions());
1.31 matthew 147: return;
148: }
149: #
150: #
151: my $initialize = \&html_initialize;
152: my $output_student = \&html_outputstudent;
153: my $finish = \&html_finish;
154: #
155: if ($output_mode eq 'excel') {
156: $initialize = \&excel_initialize;
157: $output_student = \&excel_outputstudent;
158: $finish = \&excel_finish;
1.35 ! matthew 159: } elsif ($output_mode eq 'multi-sheet excel') {
! 160: $initialize = \&multi_sheet_excel_initialize;
! 161: $output_student = \&multi_sheet_excel_outputstudent;
! 162: $finish = \&multi_sheet_excel_finish;
1.31 matthew 163: } elsif ($output_mode eq 'csv') {
164: $initialize = \&csv_initialize;
165: $output_student = \&csv_outputstudent;
166: $finish = \&csv_finish;
167: }
1.30 matthew 168: #
169: if($c->aborted()) { return ; }
1.31 matthew 170: #
171: # Call the initialize routine selected above
172: $initialize->($r);
1.30 matthew 173: foreach my $student (@Apache::lonstatistics::Students) {
1.31 matthew 174: if($c->aborted()) {
175: $finish->($r);
176: return ;
1.1 stredwic 177: }
1.31 matthew 178: # Call the output_student routine selected above
179: $output_student->($r,$student);
180: }
181: # Call the "finish" routine selected above
182: $finish->($r);
183: #
184: return;
185: }
186:
187: #######################################################
188: #######################################################
1.30 matthew 189:
1.31 matthew 190: sub get_student_fields_to_show {
191: my @to_show = @Apache::lonstatistics::SelectedStudentData;
192: foreach (@to_show) {
193: if ($_ eq 'all') {
194: @to_show = @Apache::lonstatistics::StudentDataOrder;
195: last;
196: }
197: }
198: return @to_show;
199: }
200:
201: sub get_sequences_to_show {
202: my @Sequences;
203: foreach my $map_symb (@Apache::lonstatistics::SelectedMaps) {
204: foreach my $sequence (@Apache::lonstatistics::Sequences) {
205: next if ($sequence->{'symb'} ne $map_symb && $map_symb ne 'all');
206: next if ($sequence->{'num_assess'} < 1);
207: push (@Sequences,$sequence);
208: }
1.1 stredwic 209: }
1.31 matthew 210: return @Sequences;
1.2 stredwic 211: }
1.30 matthew 212:
1.31 matthew 213:
1.28 matthew 214: #######################################################
215: #######################################################
216:
217: =pod
1.2 stredwic 218:
1.28 matthew 219: =item &CreateInterface()
1.21 minaeibi 220:
1.28 matthew 221: Called by &BuildStudentAssessmentPage to create the top part of the
222: page which displays the chart.
223:
1.30 matthew 224: Inputs: None
1.28 matthew 225:
226: Returns: A string containing the HTML for the headers and top table for
227: the chart page.
228:
229: =cut
230:
231: #######################################################
232: #######################################################
1.2 stredwic 233: sub CreateInterface {
1.4 stredwic 234: my $Str = '';
1.30 matthew 235: # $Str .= &CreateLegend();
236: $Str .= '<table cellspacing="5">'."\n";
237: $Str .= '<tr>';
238: $Str .= '<td align="center"><b>Sections</b></td>';
239: $Str .= '<td align="center"><b>Student Data</b></td>';
1.35 ! matthew 240: $Str .= '<td align="center"><b>Problem Sets</b></td>';
1.31 matthew 241: $Str .= '<td align="center"><b>Output Format</b></td>';
1.30 matthew 242: $Str .= '</tr>'."\n";
243: #
1.4 stredwic 244: $Str .= '<tr><td align="center">'."\n";
1.29 matthew 245: $Str .= &Apache::lonstatistics::SectionSelect('Section','multiple',5);
1.4 stredwic 246: $Str .= '</td><td align="center">';
1.30 matthew 247: my $only_seq_with_assessments = sub {
248: my $s=shift;
249: if ($s->{'num_assess'} < 1) {
250: return 0;
251: } else {
252: return 1;
253: }
254: };
255: $Str .= &Apache::lonstatistics::StudentDataSelect('StudentData','multiple',
256: 5,undef);
1.4 stredwic 257: $Str .= '</td><td>'."\n";
1.30 matthew 258: $Str .= &Apache::lonstatistics::MapSelect('Maps','multiple,all',5,
259: $only_seq_with_assessments);
1.31 matthew 260: $Str .= '</td><td>'."\n";
261: $Str .= &CreateAndParseOutputSelector();
1.30 matthew 262: $Str .= '</td></tr>'."\n";
263: $Str .= '</table>'."\n";
1.4 stredwic 264: return $Str;
1.1 stredwic 265: }
1.30 matthew 266:
267: #######################################################
268: #######################################################
269:
270: =pod
271:
1.31 matthew 272: =item &CreateAndParseOutputSelector()
1.30 matthew 273:
274: =cut
275:
276: #######################################################
277: #######################################################
1.32 matthew 278: my @OutputOptions =
279: ({ name => 'HTML, with links',
280: value => 'html, with links',
1.33 matthew 281: description => 'Output HTML with each symbol linked to the problem '.
1.35 ! matthew 282: 'which generated it.',
! 283: mode => 'html',
! 284: show => 'all',
! 285: show_links => 'yes',
! 286: },
1.32 matthew 287: { name => 'HTML, without links',
288: value => 'html, without links',
1.33 matthew 289: description => 'Output HTML. By not including links, the size of the'.
290: ' web page is greatly reduced. If your browser crashes on the '.
1.35 ! matthew 291: 'full display, try this.',
! 292: mode => 'html',
! 293: show => 'all',
! 294: show_links => 'no',
! 295: },
1.33 matthew 296: { name => 'HTML, scores only',
297: value => 'html, scores only',
298: description => 'Output HTML, only showing the total number of correct'.
299: ' problems (or problem parts) and not the maximum possible for '.
1.35 ! matthew 300: 'each student',
! 301: mode => 'html',
! 302: show => 'scores',
! 303: show_links => 'no',
! 304: },
1.32 matthew 305: { name => 'HTML, totals',
306: value => 'html, totals',
1.33 matthew 307: description => 'Output HTML, but only the summary statistics for each'.
1.35 ! matthew 308: ' sequence selected.',
! 309: mode => 'html',
! 310: show => 'totals',
! 311: show_links => 'no',
! 312: },
1.33 matthew 313: { name => 'Excel, scores only',
314: value => 'excel, scores only',
315: description => 'Output an Excel file (compatable with Excel 95), '.
316: 'with a single column for each sequence showing the students '.
1.35 ! matthew 317: 'score.',
! 318: mode => 'excel',
! 319: show => 'scores',
! 320: show_links => 'no',
! 321: },
1.32 matthew 322: { name => 'Excel, totals',
323: value => 'excel, totals',
1.33 matthew 324: description => 'Output an Excel file (compatable with Excel 95), '.
325: 'with two columns for each sequence, the students score on the '.
1.35 ! matthew 326: 'sequence and the students maximum possible on the sequence',
! 327: mode => 'excel',
! 328: show => 'totals',
! 329: show_links => 'no',
! 330: },
! 331: { name => 'multi-sheet Excel',
! 332: value => 'multi-sheet excel',
! 333: description => 'Output an Excel file (compatable with Excel 95), '.
! 334: 'with a seperate worksheet for each sequence you have selected '.
! 335: 'the data for each problem part '.
! 336: '(number of tries, status, points awarded) will be listed.',
! 337: mode => 'multi-sheet excel',
! 338: show => 'totals',
! 339: show_links => 'no',
! 340: },
! 341: { name => 'multi-sheet Excel, by section',
! 342: value => 'multi-sheet excel, by section',
! 343: description => 'Output an Excel file (compatable with Excel 95), '.
! 344: 'with a seperate worksheet for each sequence you have selected '.
! 345: 'the data for each problem part '.
! 346: '(number of tries, status, points awarded) will be listed. '.
! 347: 'There will be one Excel workbook for each section selected.',
! 348: mode => 'multi-sheet excel',
! 349: show => 'by section',
! 350: show_links => 'no',
! 351: },
1.33 matthew 352: { name => 'CSV, everything',
353: value => 'csv, everything',
1.35 ! matthew 354: description => '',
! 355: mode => 'csv',
! 356: show => 'all',
! 357: show_links => 'no',
! 358: },
1.33 matthew 359: { name => 'CSV, scores only',
360: value => 'csv, scores only',
1.35 ! matthew 361: description => '',
! 362: mode => 'csv',
! 363: show => 'scores',
! 364: show_links => 'no',
! 365: },
1.32 matthew 366: { name => 'CSV, totals',
367: value => 'csv, totals',
1.35 ! matthew 368: description => '',
! 369: mode => 'csv',
! 370: show => 'totals',
! 371: show_links => 'no',
! 372: },
1.32 matthew 373: );
374:
1.33 matthew 375: sub OutputDescriptions {
376: my $Str = '';
377: $Str .= "<h2>Output Modes</h2>\n";
378: $Str .= "<dl>\n";
379: foreach my $outputmode (@OutputOptions) {
380: $Str .=" <dt>".$outputmode->{'name'}."</dt>\n";
381: $Str .=" <dd>".$outputmode->{'description'}."</dd>\n";
382: }
383: $Str .= "</dl>\n";
384: return $Str;
385: }
386:
1.31 matthew 387: sub CreateAndParseOutputSelector {
388: my $Str = '';
389: my $elementname = 'outputmode';
390: #
391: # Format for output options is 'mode, restrictions';
392: my $selected = 'html, with links';
393: if (exists($ENV{'form.'.$elementname})) {
394: if (ref($ENV{'form.'.$elementname} eq 'ARRAY')) {
395: $selected = $ENV{'form.'.$elementname}->[0];
396: } else {
397: $selected = $ENV{'form.'.$elementname};
398: }
399: }
400: #
401: # Set package variables describing output mode
402: $show_links = 'no';
403: $output_mode = 'html';
404: $show = 'all';
1.35 ! matthew 405: foreach my $option (@OutputOptions) {
! 406: next if ($option->{'value'} ne $selected);
! 407: $output_mode = $option->{'mode'};
! 408: $show = $option->{'show'};
! 409: $show_links = $option->{'show_links'};
1.31 matthew 410: }
1.35 ! matthew 411:
1.31 matthew 412: #
413: # Build the form element
414: $Str = qq/<select size="5" name="$elementname">/;
1.32 matthew 415: foreach my $option (@OutputOptions) {
416: $Str .= "\n".' <option value="'.$option->{'value'}.'"';
417: $Str .= " selected " if ($option->{'value'} eq $selected);
418: $Str .= ">".$option->{'name'}."<\/option>";
1.31 matthew 419: }
420: $Str .= "\n</select>";
421: return $Str;
422: }
1.30 matthew 423:
1.28 matthew 424: #######################################################
425: #######################################################
1.1 stredwic 426:
1.28 matthew 427: =pod
428:
1.31 matthew 429: =head2 HTML output routines
1.28 matthew 430:
1.31 matthew 431: =item &html_initialize($r)
1.28 matthew 432:
1.31 matthew 433: Create labels for the columns of student data to show.
1.28 matthew 434:
1.31 matthew 435: =item &html_outputstudent($r,$student)
1.28 matthew 436:
1.31 matthew 437: Return a line of the chart for a student.
1.28 matthew 438:
1.31 matthew 439: =item &html_finish($r)
1.28 matthew 440:
441: =cut
442:
443: #######################################################
444: #######################################################
1.31 matthew 445: {
446: my $padding;
447: my $count;
448:
449: sub html_initialize {
450: my ($r) = @_;
1.30 matthew 451: #
452: $padding = ' 'x3;
1.35 ! matthew 453: $count = 0;
1.30 matthew 454: #
1.31 matthew 455: my $Str = "<pre>\n";
1.30 matthew 456: # First, the @StudentData fields need to be listed
1.31 matthew 457: my @to_show = &get_student_fields_to_show();
1.30 matthew 458: foreach my $field (@to_show) {
459: my $title=$Apache::lonstatistics::StudentData{$field}->{'title'};
460: my $base =$Apache::lonstatistics::StudentData{$field}->{'base_width'};
461: my $width=$Apache::lonstatistics::StudentData{$field}->{'width'};
462: $Str .= $title.' 'x($width-$base).$padding;
463: }
464: # Now the selected sequences need to be listed
1.31 matthew 465: foreach my $sequence (&get_sequences_to_show) {
466: my $title = $sequence->{'title'};
467: my $base = $sequence->{'base_width'};
468: my $width = $sequence->{'width'};
469: $Str .= $title.' 'x($width-$base).$padding;
1.30 matthew 470: }
1.31 matthew 471: $Str .= "total (of shown problems)</pre>\n";
472: $Str .= "<pre>";
473: $r->print($Str);
474: $r->rflush();
475: return;
1.30 matthew 476: }
477:
1.31 matthew 478: sub html_outputstudent {
479: my ($r,$student) = @_;
1.2 stredwic 480: my $Str = '';
1.35 ! matthew 481: #
! 482: if($count++ % 5 == 0 && $count > 0) {
! 483: $r->print("</pre><pre>");
! 484: }
1.30 matthew 485: # First, the @StudentData fields need to be listed
1.31 matthew 486: my @to_show = &get_student_fields_to_show();
1.30 matthew 487: foreach my $field (@to_show) {
488: my $title=$student->{$field};
1.31 matthew 489: my $base = length($title);
1.30 matthew 490: my $width=$Apache::lonstatistics::StudentData{$field}->{'width'};
491: $Str .= $title.' 'x($width-$base).$padding;
492: }
493: # Get ALL the students data
494: my %StudentsData;
495: my @tmp = &Apache::loncoursedata::get_current_state
496: ($student->{'username'},$student->{'domain'},undef,
497: $ENV{'request.course.id'});
498: if ((scalar @tmp > 0) && ($tmp[0] !~ /^error:/)) {
499: %StudentsData = @tmp;
500: }
501: if (scalar(@tmp) < 1) {
502: $Str .= '<font color="blue">No Course Data</font>'."\n";
1.31 matthew 503: $r->print($Str);
504: $r->rflush();
505: return;
1.30 matthew 506: }
507: #
508: # By sequence build up the data
509: my $studentstats;
1.31 matthew 510: my $PerformanceStr = '';
511: foreach my $seq (&get_sequences_to_show) {
512: my ($performance,$score,$seq_max) =
513: &StudentPerformanceOnSequence($student,\%StudentsData,
514: $seq,$show_links);
515: my $ratio = $score.'/'.$seq_max;
516: #
517: if ($show eq 'totals') {
518: $performance = ' 'x(length($seq_max)-length($score)).$ratio;
519: $performance .= ' 'x($seq->{'width'}-length($performance));
1.32 matthew 520: } elsif ($show eq 'scores') {
521: $performance = $score;
522: $performance .= ' 'x($seq->{'width'}-length($performance));
1.31 matthew 523: } else {
524: # Pad with extra spaces
525: $performance .= ' 'x($seq->{'width'}-$seq_max-
526: length($ratio)
527: ).$ratio;
1.30 matthew 528: }
1.31 matthew 529: #
530: $Str .= $performance.$padding;
531: #
532: $studentstats->{$seq->{'symb'}}->{'score'}= $score;
533: $studentstats->{$seq->{'symb'}}->{'max'} = $seq_max;
1.30 matthew 534: }
535: #
536: # Total it up and store the statistics info.
537: my ($score,$max) = (0,0);
538: while (my ($symb,$seq_stats) = each (%{$studentstats})) {
539: $Statistics->{$symb}->{'score'} += $seq_stats->{'score'};
540: $Statistics->{$symb}->{'max'} += $seq_stats->{'max'};
541: $score += $seq_stats->{'score'};
542: $max += $seq_stats->{'max'};
543: }
1.31 matthew 544: $Str .= ' '.' 'x(length($max)-length($score)).$score.'/'.$max;
1.30 matthew 545: $Str .= " \n";
1.31 matthew 546: $r->print($Str);
547: #
548: $r->rflush();
549: return;
1.30 matthew 550: }
1.2 stredwic 551:
1.31 matthew 552: sub html_finish {
553: my ($r) = @_;
554: $r->print("</pre>\n");
555: $r->rflush();
556: return;
557: }
558:
559: }
560:
1.35 ! matthew 561: #######################################################
! 562: #######################################################
! 563:
! 564: =pod
! 565:
! 566: =head2 Multi-Sheet EXCEL subroutines
! 567:
! 568: =item &multi_sheet_excel_initialize($r)
! 569:
! 570: =item &multi_sheet_excel_outputstudent($r,$student)
! 571:
! 572: =item &multi_sheet_excel_finish($r)
! 573:
! 574: =cut
! 575:
! 576: #######################################################
! 577: #######################################################
! 578: {
! 579:
! 580: sub multi_sheet_excel_initialize {
! 581: my ($r)=@_;
! 582: $r->print("<h1>Not yet implemented</h1>");
! 583: #
! 584: # Estimate the size of the file. We would like to have < 5 megs of data.
! 585: my $max_size = 5000000;
! 586: my $num_students = scalar(@Apache::lonstatistics::Students);
! 587: my $num_sequences = 0;
! 588: my $num_data_per_part = 2; # 'status' and 'numtries'
! 589: my $fields_per_student = scalar(&get_student_fields_to_show());
! 590: my $bytes_per_field = 20; # Back of the envelope calculation
! 591: foreach my $seq (&get_sequences_to_show) {
! 592: $num_sequences++ if ($seq->{'num_assess'} > 0);
! 593: $fields_per_student += $num_data_per_part * $seq->{'num_assess_parts'};
! 594: }
! 595: my $size_estimate = $fields_per_student*$num_students*$bytes_per_field;
! 596: #
! 597: # Compute number of workbooks
! 598: my $num_workbooks = 1;
! 599: if ($size_estimate > $max_size) { # try to stay under 5 megs
! 600: $num_workbooks += int($size_estimate / $max_size);
! 601: }
! 602: if ($show eq 'by section') {
! 603: if (@Apache::lonstatistics::SelectedSections > 1 &&
! 604: $Apache::lonstatistics::SelectedSections[0] ne 'all') {
! 605: $num_workbooks = scalar(@Apache::lonstatistics::SelectedSections);
! 606: } else {
! 607: # @Apache::lonstatistics::Sections contains 'all' as well.
! 608: $num_workbooks = scalar(@Apache::lonstatistics::Sections) - 1;
! 609: }
! 610: }
! 611:
! 612: $r->print("Maximum allowed size: ".$max_size." bytes<br />");
! 613: $r->print("Number of students: ".$num_students."<br />");
! 614: $r->print("Number of fields per student: ".$fields_per_student."<br />");
! 615: $r->print("Total number of fields: ".($fields_per_student*$num_students).
! 616: "<br />");
! 617: $r->print("Bytes per field: ".$bytes_per_field." (estimated)"."<br />");
! 618: $r->print("Estimated size: ".$size_estimate." bytes<br />");
! 619: $r->print("Number of workbooks: ".$num_workbooks."<br />");
! 620: $r->rflush();
! 621: return;
! 622: }
! 623:
! 624: sub multi_sheet_excel_outputstudent {
! 625: my ($r,$student) = @_;
! 626: }
! 627:
! 628: sub multi_sheet_excel_finish {
! 629: my ($r) = @_;
! 630: }
! 631:
! 632: }
1.31 matthew 633: #######################################################
634: #######################################################
635:
636: =pod
637:
638: =head2 EXCEL subroutines
639:
640: =item &excel_initialize($r)
641:
642: =item &excel_outputstudent($r,$student)
643:
644: =item &excel_finish($r)
645:
646: =cut
647:
648: #######################################################
649: #######################################################
650: {
651:
652: my $excel_sheet;
1.32 matthew 653: my $excel_workbook;
654:
655: my $filename;
656: my $rows_output;
657: my $cols_output;
658:
659: my $num_students;
660: my $start_time;
1.31 matthew 661:
662: sub excel_initialize {
663: my ($r) = @_;
664: #
1.32 matthew 665: $filename = '/prtspool/'.
1.31 matthew 666: $ENV{'user.name'}.'_'.$ENV{'user.domain'}.'_'.
667: time.'_'.rand(1000000000).'.xls';
1.32 matthew 668: #
669: $excel_workbook = undef;
670: $excel_sheet = undef;
671: #
672: $rows_output = 0;
673: $cols_output = 0;
674: #
675: $num_students = 0;
676: $start_time = time;
677: #
678: # Create sheet
679: $excel_workbook = Spreadsheet::WriteExcel->new('/home/httpd'.$filename);
680: #
681: # Check for errors
682: if (! defined($excel_workbook)) {
1.31 matthew 683: $r->log_error("Error creating excel spreadsheet $filename: $!");
684: $r->print("Problems creating new Excel file. ".
685: "This error has been logged. ".
686: "Please alert your LON-CAPA administrator");
1.32 matthew 687: return ;
1.31 matthew 688: }
689: #
690: # The excel spreadsheet stores temporary data in files, then put them
691: # together. If needed we should be able to disable this (memory only).
692: # The temporary directory must be specified before calling 'addworksheet'.
693: # File::Temp is used to determine the temporary directory.
1.32 matthew 694: $excel_workbook->set_tempdir($Apache::lonnet::tmpdir);
695: #
696: # Add a worksheet
1.33 matthew 697: my $sheetname = $ENV{'course.'.$ENV{'request.course.id'}.'.description'};
698: if (length($sheetname) > 31) {
699: $sheetname = substr($sheetname,0,31);
700: }
701: $excel_sheet = $excel_workbook->addworksheet($sheetname);
1.32 matthew 702: #
1.34 matthew 703: # Put the course description in the header
704: $excel_sheet->write($rows_output,$cols_output++,
705: $ENV{'course.'.$ENV{'request.course.id'}.'.description'});
706: $cols_output += 3;
707: #
708: # Put a description of the sections listed
709: my $sectionstring = '';
710: my @Sections = @Apache::lonstatistics::SelectedSections;
711: if (scalar(@Sections) > 1) {
712: if (scalar(@Sections) > 2) {
713: my $last = pop(@Sections);
714: $sectionstring = "Sections ".join(', ',@Sections).', and '.$last;
715: } else {
716: $sectionstring = "Sections ".join(' and ',@Sections);
717: }
718: } else {
719: if ($Sections[0] eq 'all') {
720: $sectionstring = "All sections";
721: } else {
722: $sectionstring = "Section ".$Sections[0];
723: }
724: }
725: $excel_sheet->write($rows_output,$cols_output++,$sectionstring);
726: $cols_output += scalar(@Sections);
727: #
728: # Put the date in there too
729: $excel_sheet->write($rows_output,$cols_output++,
730: 'Compiled on '.localtime(time));
731: #
732: $rows_output++;
733: #
1.32 matthew 734: # Add the student headers
1.34 matthew 735: $cols_output = 0;
1.32 matthew 736: foreach my $field (&get_student_fields_to_show()) {
1.34 matthew 737: $excel_sheet->write($rows_output,$cols_output++,$field);
1.32 matthew 738: }
739: #
740: # Add the Sequence Headers
741: foreach my $seq (&get_sequences_to_show) {
1.34 matthew 742: $excel_sheet->write($rows_output,$cols_output,$seq->{'title'});
1.32 matthew 743: if ($show eq 'totals') {
1.34 matthew 744: $excel_sheet->write($rows_output+1,$cols_output,'score');
745: $excel_sheet->write($rows_output+1,$cols_output+1,'maximum');
1.32 matthew 746: $cols_output += 2;
747: } else {
748: $cols_output++;
749: }
750: }
751: #
752: # Bookkeeping
753: if ($show eq 'totals') {
1.34 matthew 754: $rows_output += 2;
1.32 matthew 755: } else {
1.34 matthew 756: $rows_output += 1;
1.32 matthew 757: }
758: #
759: # Let the user know what we are doing
760: my $studentcount = scalar(@Apache::lonstatistics::Students);
761: $r->print("<h1>Compiling Excel spreadsheet for ".
762: $studentcount.' student');
763: $r->print('s') if ($studentcount > 1);
764: $r->print("</h1>\n");
765: $r->rflush();
1.31 matthew 766: #
767: return;
768: }
769:
770: sub excel_outputstudent {
771: my ($r,$student) = @_;
1.32 matthew 772: return if (! defined($excel_sheet));
773: $cols_output=0;
774: #
775: # Write out student data
776: my @to_show = &get_student_fields_to_show();
777: foreach my $field (@to_show) {
778: $excel_sheet->write($rows_output,$cols_output++,$student->{$field});
779: }
780: #
781: # Get student assessment data
782: my %StudentsData;
783: my @tmp = &Apache::loncoursedata::get_current_state($student->{'username'},
784: $student->{'domain'},
785: undef,
786: $ENV{'request.course.id'});
787: if ((scalar @tmp > 0) && ($tmp[0] !~ /^error:/)) {
788: %StudentsData = @tmp;
789: }
790: #
791: # Write out sequence scores and totals data
792: foreach my $seq (&get_sequences_to_show) {
793: my ($performance,$score,$seq_max) =
794: &StudentPerformanceOnSequence($student,\%StudentsData,
795: $seq,'no');
796: if ($show eq 'totals' || $show eq 'scores') {
797: $excel_sheet->write($rows_output,$cols_output++,$score);
798: }
799: if ($show eq 'totals') {
800: $excel_sheet->write($rows_output,$cols_output++,$seq_max);
801: }
802: }
803: #
804: # Bookkeeping
805: $rows_output++;
806: $cols_output=0;
807: #
808: # Time estimate
809: $num_students++;
810: if ($num_students % 10 == 0) {
811: my $time_est = (time - $start_time)/$num_students *
812: (scalar(@Apache::lonstatistics::Students)-$num_students);
813: $time_est = int($time_est);
814: if (int ($time_est/60) > 0) {
815: my $min = int($time_est/60);
816: my $sec = $time_est % 60;
817: $time_est = $min.' minutes';
818: if ($sec > 1) {
819: $time_est.= ', '.$sec.' seconds';
820: } elsif ($sec > 0) {
821: $time_est.= ', '.$sec.' second';
822: }
823: } else {
824: $time_est .= ' seconds';
825: }
826: $r->print($num_students.' out of '.
827: (scalar(@Apache::lonstatistics::Students)).
828: " students processed. ".
1.34 matthew 829: $time_est." remain. Elapsed: ".(time - $start_time).
830: "<br />\n");
1.32 matthew 831: $r->rflush();
832: }
833: return;
1.31 matthew 834: }
835:
836: sub excel_finish {
837: my ($r) = @_;
1.32 matthew 838: return if (! defined($excel_sheet));
839: #
840: # Write the excel file
841: $excel_workbook->close();
842: my $c = $r->connection();
843: #
844: return if($c->aborted());
845: #
846: # Tell the user where to get their excel file
847: $r->print('<br /><br />'.
848: '<a href="'.$filename.'">Your Excel spreadsheet.</a>'."\n");
849: my $total_time = time - $start_time;
850: if (int ($total_time / 60) > 0) {
851: $total_time = int($total_time/60).' minutes, '.($total_time % 60);
852: }
853: $r->print('<br />'.$total_time.' seconds total');
854: $r->rflush();
855: return;
1.31 matthew 856: }
857:
858: }
1.30 matthew 859: #######################################################
860: #######################################################
861:
862: =pod
863:
1.31 matthew 864: =head2 CSV output routines
865:
866: =item &csv_initialize($r)
867:
868: =item &csv_outputstudent($r,$student)
869:
870: =item &csv_finish($r)
1.30 matthew 871:
872: =cut
873:
874: #######################################################
875: #######################################################
1.31 matthew 876: {
877:
878: sub csv_initialize{
879: my ($r) = @_;
880: $r->print("<h1>Not implemented yet</h1>");
881: return;
882: }
883:
884: sub csv_outputstudent {
885: my ($r,$student) = @_;
886: }
887:
888: sub csv_finish {
889: my ($r) = @_;
890: }
1.2 stredwic 891:
892: }
893:
1.28 matthew 894: #######################################################
895: #######################################################
896:
1.2 stredwic 897: =pod
898:
1.30 matthew 899: =item &StudentPerformanceOnSequence()
1.2 stredwic 900:
1.30 matthew 901: Inputs:
1.2 stredwic 902:
903: =over 4
904:
1.30 matthew 905: =item $student
1.28 matthew 906:
1.30 matthew 907: =item $studentdata Hash ref to all student data
1.2 stredwic 908:
1.30 matthew 909: =item $seq Hash ref, the sequence we are working on
1.2 stredwic 910:
1.30 matthew 911: =item $links if defined we will output links to each resource.
1.2 stredwic 912:
1.28 matthew 913: =back
1.2 stredwic 914:
915: =cut
1.1 stredwic 916:
1.28 matthew 917: #######################################################
918: #######################################################
1.30 matthew 919: sub StudentPerformanceOnSequence {
1.32 matthew 920: my ($student,$studentdata,$seq,$links) = @_;
1.31 matthew 921: $links = 'no' if (! defined($links));
1.1 stredwic 922: my $Str = '';
1.30 matthew 923: my ($sum,$max) = (0,0);
924: foreach my $resource (@{$seq->{'contents'}}) {
925: next if ($resource->{'type'} ne 'assessment');
926: my $resource_data = $studentdata->{$resource->{'symb'}};
927: my $value = '';
928: foreach my $partnum (@{$resource->{'parts'}}) {
929: $max++;
930: my $symbol = ' '; # default to space
931: #
932: if (exists($resource_data->{'resource.'.$partnum.'.solved'})) {
933: my $status = $resource_data->{'resource.'.$partnum.'.solved'};
934: if ($status eq 'correct_by_override') {
935: $symbol = '+';
936: $sum++;
937: } elsif ($status eq 'incorrect_by_override') {
938: $symbol = '-';
939: } elsif ($status eq 'ungraded_attempted') {
940: $symbol = '#';
941: } elsif ($status eq 'incorrect_attempted') {
942: $symbol = '.';
943: } elsif ($status eq 'excused') {
944: $symbol = 'x';
945: $max--;
946: } elsif ($status eq 'correct_by_student' &&
947: exists($resource_data->{'resource.'.$partnum.'.tries'})){
948: my $num = $resource_data->{'resource.'.$partnum.'.tries'};
949: if ($num > 9) {
950: $symbol = '*';
951: } elsif ($num > 0) {
952: $symbol = $num;
953: } else {
954: $symbol = ' ';
955: }
956: $sum++;
957: } else {
958: $symbol = ' ';
1.2 stredwic 959: }
1.30 matthew 960: } else {
961: # Unsolved. Did they try?
962: if (exists($resource_data->{'resource.'.$partnum.'.tries'})){
963: $symbol = '.';
964: } else {
965: $symbol = ' ';
1.18 matthew 966: }
1.2 stredwic 967: }
1.30 matthew 968: #
1.31 matthew 969: if ($links eq 'yes' && $symbol ne ' ') {
1.30 matthew 970: $symbol = '<a href="/adm/grades'.
971: '?symb='.&Apache::lonnet::escape($resource->{'symb'}).
972: '&student='.$student->{'username'}.
973: '&domain='.$student->{'domain'}.
974: '&command=submission">'.$symbol.'</a>';
975: }
976: $value .= $symbol;
1.2 stredwic 977: }
1.30 matthew 978: $Str .= $value;
1.17 minaeibi 979: }
1.30 matthew 980: return ($Str,$sum,$max);
1.17 minaeibi 981: }
982:
1.28 matthew 983: #######################################################
984: #######################################################
1.17 minaeibi 985: sub StudentAverageTotal {
1.21 minaeibi 986: my ($cache, $students, $sequenceKeys)=@_;
1.23 minaeibi 987: my $Str = "\n<b>Summary Tables:</b>\n";
1.21 minaeibi 988: my %Correct = ();
989: my $ProblemsSolved = 0;
990: my $TotalProblems = 0;
991: my $StudentCount = 0;
992:
993: foreach my $name (@$students) {
994: $StudentCount++;
995: foreach my $sequence (@$sequenceKeys) {
1.23 minaeibi 996: $Correct{$sequence} +=
997: $cache->{$name.':'.$sequence.':problemsCorrect'};
1.17 minaeibi 998: }
1.21 minaeibi 999: $ProblemsSolved += $cache->{$name.':problemsSolved'};
1000: $TotalProblems += $cache->{$name.':totalProblems'};
1.1 stredwic 1001: }
1.25 matthew 1002: if ($StudentCount) {
1.27 minaeibi 1003: $ProblemsSolved = sprintf( "%.2f",
1004: $ProblemsSolved/$StudentCount);
1.25 matthew 1005: $TotalProblems /= $StudentCount;
1006: } else {
1007: $ProblemsSolved = 0;
1008: $TotalProblems = 0;
1009: }
1.27 minaeibi 1010:
1.24 minaeibi 1011: $Str .= '<table border=2 cellspacing="1">'."\n";
1.23 minaeibi 1012: $Str .= '<tr><td><b>Students Count</b></td><td><b>'.
1013: $StudentCount.'</b></td></tr>'."\n";
1014: $Str .= '<tr><td><b>Total Problems</b></td><td><b>'.
1015: $TotalProblems.'</b></td></tr>'."\n";
1016: $Str .= '<tr><td><b>Average Correct</b></td><td><b>'.
1017: $ProblemsSolved.'</b></td></tr>'."\n";
1018: $Str .= '</table>'."\n";
1019:
1.24 minaeibi 1020: $Str .= '<table border=2 cellspacing="1">'."\n";
1.23 minaeibi 1021: $Str .= '<tr><th>Title</th><th>Total Problems</th>'.
1022: '<th>Average Correct</th></tr>'."\n";
1023: foreach my $S(@$sequenceKeys) {
1024: my $title=$cache->{$S.':title'};
1025: #$Str .= $cache->{$S.':problems'};
1.24 minaeibi 1026: #my @problems=split(':', $cache->{$S.':problems'});
1.23 minaeibi 1027: #my $pCount=scalar @problems;
1028: my $pCount=MaxSeqPr($cache,@$students[0],$S);
1.25 matthew 1029: my $crr;
1030: if ($StudentCount) {
1031: $crr=sprintf( "%.2f", $Correct{$S}/$StudentCount );
1032: } else {
1033: $crr="0.00";
1034: }
1.23 minaeibi 1035: $Str .= '<tr><td>'.$title.
1036: '</td><td align=center>'.$pCount.
1037: '</td><td align=center>'.$crr.
1038: '</td></tr>'."\n";
1.10 stredwic 1039: }
1.1 stredwic 1040:
1.23 minaeibi 1041: $Str .= '</table>'."\n";
1042:
1.1 stredwic 1043: return $Str;
1044: }
1.23 minaeibi 1045:
1.28 matthew 1046: #######################################################
1047: #######################################################
1.23 minaeibi 1048:
1.2 stredwic 1049: =pod
1050:
1051: =item &CreateLegend()
1052:
1053: This function returns a formatted string containing the legend for the
1054: chart. The legend describes the symbols used to represent grades for
1055: problems.
1056:
1057: =cut
1058:
1.28 matthew 1059: #######################################################
1060: #######################################################
1.2 stredwic 1061: sub CreateLegend {
1062: my $Str = "<p><pre>".
1.13 minaeibi 1063: " 1 correct by student in 1 try\n".
1064: " 7 correct by student in 7 tries\n".
1.12 minaeibi 1065: " * correct by student in more than 9 tries\n".
1.20 minaeibi 1066: " + correct by hand grading or override\n".
1.12 minaeibi 1067: " - incorrect by override\n".
1068: " . incorrect attempted\n".
1069: " # ungraded attempted\n".
1.13 minaeibi 1070: " not attempted (blank field)\n".
1.12 minaeibi 1071: " x excused".
1.17 minaeibi 1072: "</pre><p>";
1.2 stredwic 1073: return $Str;
1074: }
1075:
1.28 matthew 1076: #######################################################
1077: #######################################################
1078:
1.30 matthew 1079: =pod
1.2 stredwic 1080:
1081: =back
1082:
1083: =cut
1084:
1.28 matthew 1085: #######################################################
1086: #######################################################
1.2 stredwic 1087:
1.28 matthew 1088: 1;
1.2 stredwic 1089:
1.1 stredwic 1090: __END__
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>
![[BACK]](/icons/back.gif){kind=icon}
Return to lonstudentassessment.pm CVS log ![[TXT]](/icons/text.gif){kind=icon}
![[DIR]](/icons/dir.gif){kind=icon}
Up to [LON-CAPA] / loncom / interface / statistics