Annotation of loncom/interface/statistics/lonsurveyreports.pm, revision 1.2

1.1       matthew     1: # The LearningOnline Network with CAPA
                      2: #
1.2     ! matthew     3: # $Id: lonsurveyreports.pm,v 1.1 2004/06/15 14:22:45 matthew Exp $
1.1       matthew     4: #
                      5: # Copyright Michigan State University Board of Trustees
                      6: #
                      7: # This file is part of the LearningOnline Network with CAPA (LON-CAPA).
                      8: #
                      9: # LON-CAPA is free software; you can redistribute it and/or modify
                     10: # it under the terms of the GNU General Public License as published by
                     11: # the Free Software Foundation; either version 2 of the License, or
                     12: # (at your option) any later version.
                     13: #
                     14: # LON-CAPA is distributed in the hope that it will be useful,
                     15: # but WITHOUT ANY WARRANTY; without even the implied warranty of
                     16: # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
                     17: # GNU General Public License for more details.
                     18: #
                     19: # You should have received a copy of the GNU General Public License
                     20: # along with LON-CAPA; if not, write to the Free Software
                     21: # Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
                     22: #
                     23: # /home/httpd/html/adm/gpl.txt
                     24: #
                     25: # http://www.lon-capa.org/
                     26: #
                     27: package Apache::lonsurveyreports;
                     28: 
                     29: use strict;
                     30: use Apache::lonnet();
                     31: use Apache::loncommon();
                     32: use Apache::lonhtmlcommon();
                     33: use Apache::loncoursedata();
                     34: use Apache::lonstatistics;
                     35: use Apache::lonlocal;
                     36: use Apache::lonstathelpers;
                     37: use HTML::Entities();
                     38: use Time::Local();
                     39: 
                     40: my @SubmitButtons = ({ name => 'PrevProblem',
                     41:                        text => 'Previous Survey' },
                     42:                      { name => 'NextProblem',
                     43:                        text => 'Next Survey' },
                     44:                      { name => 'break'},
                     45:                      { name => 'SelectAnother',
                     46:                        text => 'Choose a different Survey Problem' },
                     47:                      { name => 'Generate',
                     48:                        text => 'Generate Report'},
                     49:                      );
                     50: 
                     51: sub BuildSurveyReportsPage {
                     52:     my ($r,$c)=@_;
                     53:     #
                     54:     my %Saveable_Parameters = ('Status' => 'scalar',
                     55:                                'Section' => 'array',
                     56:                                'NumPlots' => 'scalar',
                     57:                                );
                     58:     &Apache::loncommon::store_course_settings('survey_reports',
                     59:                                               \%Saveable_Parameters);
                     60:     &Apache::loncommon::restore_course_settings('survey_resports',
                     61:                                                 \%Saveable_Parameters);
                     62:     #
                     63:     &Apache::lonstatistics::PrepareClasslist();
                     64:     #
                     65:     $r->print(&CreateInterface());
                     66:     #
                     67:     my @Students = @Apache::lonstatistics::Students;
                     68:     #
                     69:     if (@Students < 1) {
                     70:         $r->print('<h2>There are no students in the sections selected</h2>');
                     71:     }
                     72:     #
                     73:     my @CacheButtonHTML = 
                     74:         &Apache::lonstathelpers::manage_caches($r,'Statistics','stats_status');
                     75:     $r->rflush();
                     76:     #
                     77:     if (exists($ENV{'form.problemchoice'}) && 
                     78:         ! exists($ENV{'form.SelectAnother'})) {
                     79:         foreach my $button (@SubmitButtons) {
                     80:             if ($button->{'name'} eq 'break') {
                     81:                 $r->print("<br />\n");
                     82:             } else {
                     83:                 $r->print('<input type="submit" name="'.$button->{'name'}.'" '.
                     84:                           'value="'.&mt($button->{'text'}).'" />');
                     85:                 $r->print('&nbsp;'x5);
                     86:             }
                     87:         }
                     88:         foreach my $html (@CacheButtonHTML) {
                     89:             $r->print($html.('&nbsp;'x5));
                     90:         }
                     91:         #
                     92:         $r->print('<hr />');
                     93:         $r->rflush();
                     94:         #
                     95:         # Determine which problem we are to analyze
                     96:         my $current_problem = &Apache::lonstathelpers::get_target_from_id
                     97:             ($ENV{'form.problemchoice'});
                     98:         #
                     99:         my ($prev,$curr,$next) = 
                    100:             &Apache::lonstathelpers::get_prev_curr_next($current_problem,
                    101:                                                         '.',
                    102:                                                         'part_survey',
                    103:                                                         );
                    104:         if (exists($ENV{'form.PrevProblem'}) && defined($prev)) {
                    105:             $current_problem = $prev;
                    106:         } elsif (exists($ENV{'form.NextProblem'}) && defined($next)) {
                    107:             $current_problem = $next;
                    108:         } else {
                    109:             $current_problem = $curr;
                    110:         }
                    111:         #
                    112:         # Store the current problem choice and send it out in the form
                    113:         $ENV{'form.problemchoice'} = 
                    114:             &Apache::lonstathelpers::make_target_id($current_problem);
                    115:         $r->print('<input type="hidden" name="problemchoice" value="'.
                    116:                   $ENV{'form.problemchoice'}.'" />');
                    117:         #
                    118:         if (! defined($current_problem->{'resource'})) {
                    119:             $r->print('resource is undefined');
                    120:         } else {
                    121:             my $resource = $current_problem->{'resource'};
                    122:             $r->print('<h1>'.$resource->{'title'}.'</h1>');
                    123:             $r->print('<h3>'.$resource->{'src'}.'</h3>');
                    124:             $r->print(&Apache::lonstathelpers::render_resource($resource));
                    125:             $r->rflush();
                    126:             my %Data = &Apache::lonstathelpers::get_problem_data
                    127:                 ($resource->{'src'});
                    128:             &make_HTML_report($r,$current_problem,\%Data,\@Students);
                    129:         }
                    130:         $r->print('<hr />');
                    131:     } else {
                    132:         $r->print('<input type="submit" name="Generate" value="'.
                    133:                   &mt('Generate Survey Report').'" />');
                    134:         $r->print('&nbsp;'x5);
                    135:         $r->print('<h3>'.&mt('Please select a Survey to analyze').'</h3>');
                    136:         $r->print(&SurveyProblemSelector());
                    137:     }
                    138: }
                    139: 
                    140: ##########################################################
                    141: ##########################################################
                    142: ##
                    143: ## SurveyProblemSelector
                    144: ##
                    145: ##########################################################
                    146: ##########################################################
                    147: sub SurveyProblemSelector {
                    148:     my $Str = '';
                    149:     my @SurveyProblems;
                    150:     foreach my $seq (&Apache::lonstatistics::Sequences_with_Assess('all')) {
                    151:         next if ($seq->{'num_assess'}<1);
                    152:         foreach my $res (@{$seq->{'contents'}}) {
                    153:             next if ($res->{'type'} ne 'assessment');
                    154:             foreach my $part (@{$res->{'parts'}}) {
                    155:                 if ($res->{'partdata'}->{$part}->{'Survey'}) {
                    156:                     push(@SurveyProblems,{res=>$res,seq=>$seq,part=>$part});
                    157:                     last;
                    158:                 }
                    159:             }
                    160:         }
                    161:     }
                    162:     if (! scalar(@SurveyProblems)) {
                    163:         $Str = '<h1>'.
                    164:             &mt('There are no survey problems in this course').
                    165:             '</h1>'.$/;
                    166:         return $Str;
                    167:     }
                    168:     $Str .= '<table>'.$/;
                    169:     $Str .= '<tr>'.'<td></td>'.
                    170:         '<th>'.&mt('Sequence').'</th>'.
                    171:         '<th>'.&mt('Problem').'</th>'.
                    172:         '</tr>'.$/;
                    173:     foreach my $problem (@SurveyProblems) {
                    174:         my $value = &Apache::lonstathelpers::make_target_id
                    175:             ({symb=>$problem->{'res'}->{'symb'},
                    176:               part=>$problem->{'part'},
                    177:               respid=>undef,
                    178:               resptype=>undef});
                    179:         my $checked = '';
                    180:         if ($ENV{'form.problemchoice'} eq $value) {
                    181:             $checked = 'checked ';
                    182:         }
                    183:         $Str .= '<tr>'.'<td>'.
                    184:             '<input type="radio" name="problemchoice" '.
                    185:                    'value="'.$value.'" '.$checked.'/>'.'</td>'.
                    186:             '<td>'.$problem->{'seq'}->{'title'}.'</td>'.
                    187:             '<td>'.$problem->{'res'}->{'title'}.'</td>'.
                    188:             '</tr>'.$/;
                    189:     }
                    190:     $Str .= '</table>';
                    191:     return $Str;
                    192: }
                    193: 
                    194: #########################################################
                    195: #########################################################
                    196: ##
                    197: ## Compile Student Answers
                    198: ##
                    199: #########################################################
                    200: #########################################################
                    201: sub Compile_Student_Answers {
                    202:     my ($problem,$ProblemData,$Students) = @_;
                    203:     my $resource = $problem->{'resource'};
                    204:     foreach my $student (@$Students) {
                    205:         foreach my $partid (@{$resource->{'parts'}}) {
                    206:             my $partdata = $resource->{'partdata'}->{$partid};
                    207:             for (my $i=0;$i<=@{$partdata->{'ResponseIds'}};$i++) {
                    208:                 my $respid = $partdata->{'ResponseIds'}->[$i];
                    209:                 my $resptype = $partdata->{'ResponseTypes'}->[$i];
                    210:                 my $results = 
                    211:                     &Apache::loncoursedata::get_response_data_by_student
                    212:                     ($student,$resource->{'symb'},$respid);
                    213:                 next if (! defined($results) || ref($results) ne 'ARRAY' || 
                    214:                          ref($results->[0]) ne 'ARRAY');
                    215:                 my $student_response = 
                    216:                     $results->[0]->[&Apache::loncoursedata::RDs_submission()];
                    217:                 $problem->{'responsedata'}->{$partid}->{$respid}->{'_count'}++;
                    218:                 my $data = $problem->{'responsedata'}->{$partid}->{$respid};
                    219:                 if ($resptype =~ /^(radiobutton|optionresponse)$/) {
                    220:                     # Restricted response type can be categorized.
                    221:                     #
                    222:                     # Assume responses were not randomized and the order 
                    223:                     # represents their value.  This is probably a dumb thing
                    224:                     # to do...
                    225:                     #
                    226:                     my ($foil,$value) = split('=',$student_response);
                    227:                     $value += 1;  # explicitly increment it...
                    228:                     $data->{'foil_responses'}->{$foil}++;
                    229:                     $data->{'foil_values'}->{$value}++;
                    230:                     if (! exists($data->{'map'}->{$value})) {
                    231:                         $data->{'map'}->{$value} = $foil;
                    232:                     }
                    233:                 } else {
                    234:                     # Variable stuff (essays, raw numbers, strings) go here
                    235:                     push(@{$data->{'responses'}},$student_response);
                    236:                 }
                    237:             }
                    238:         }
                    239:     }
                    240:     return;
                    241: }
                    242: 
                    243: #########################################################
                    244: #########################################################
                    245: ##
                    246: ## make_HTML_report
                    247: ##
                    248: #########################################################
                    249: #########################################################
                    250: sub make_HTML_report {
                    251:     my ($r,$problem,$ProblemData,$Students) = @_;
                    252:     &Compile_Student_Answers($problem,$ProblemData,$Students);
                    253:     # &output_hash('',$ProblemData);
                    254:     my $resource = $problem->{'resource'};
                    255:     foreach my $partid (@{$resource->{'parts'}}) {
                    256:         my $partdata = $resource->{'partdata'}->{$partid};
                    257:         for (my $i=0;$i<=@{$partdata->{'ResponseIds'}};$i++) {
                    258:             my $Str = '<table>'.$/;
                    259:             my $respid = $partdata->{'ResponseIds'}->[$i];
                    260:             my $resptype = $partdata->{'ResponseTypes'}->[$i];
                    261:             my $data = $problem->{'responsedata'}->{$partid}->{$respid};
                    262:             next if (! defined($data) || ref($data) ne 'HASH');
                    263:             # Debugging code
                    264: #            $Str .= '<tr>'.
                    265: #                '<td>'.$partid.'</td>'.
                    266: #                '<td>'.$respid.'</td>'.
                    267: #                '<td>'.$resptype.'</td>'.
                    268: #                '</tr>'.$/;
                    269:             $Str .= '<tr>'.
                    270:                 '<td><b>'.&mt('Total').'</b></td>'.
                    271:                 '<td>'.$data->{'_count'}.'</td>'.
1.2     ! matthew   272:                 '<td>'.&mt('Part [_1], Response [_2]',$partid,$respid).'</td>'.
1.1       matthew   273:                 '</tr>'.$/;
                    274:             if (exists($data->{'responses'}) && 
                    275:                 ref($data->{'responses'}) eq 'ARRAY') {
                    276:                 &randomize_array($data->{'responses'});
                    277:                 foreach my $response (@{$data->{'responses'}}) {
                    278:                     $response =~ s/\\r\\n/\n/g;
                    279:                     $response =~ s/\\'/'/g;
                    280:                     $response =~ s/\\"/"/g;
                    281:                     $Str .= '<tr>'.
                    282:                         '<td colspan="3"><pre>'.
                    283:                         &HTML::Entities::encode($response,'<>&').
                    284:                         '</pre><hr /></td>'.
                    285:                         '</tr>'.$/;
                    286:                 }
                    287:             } elsif (exists($data->{'_count'})      && 
                    288:                      exists($data->{'foil_values'}) && 
                    289:                      exists($data->{'map'})) {
                    290:                 # This is an option or radiobutton survey response
                    291:                 my $total = $data->{'_count'};
                    292:                 my $sum = 0;
                    293:                 my $tmp;
                    294:                 foreach my $value (sort(keys(%{$data->{'foil_values'}}))) {
                    295:                     my $count = $data->{'foil_values'}->{$value};
                    296:                     my $foilid = $data->{'map'}->{$value};
                    297:                     my $foiltext = $ProblemData->{$partid.'.'.$respid}->{'_Foils'}->{$foilid}->{'text'};
                    298:                     my $foilname = $ProblemData->{$partid.'.'.$respid}->{'_Foils'}->{$foilid}->{'name'};
                    299:                     $sum = $value * $data->{'foil_values'}->{$value};
                    300:                     $tmp .= '<tr>'.
                    301:                         '<td>'.$foilname.'</td>'.
                    302:                         '<td>'.$foiltext.'</td>'.
                    303:                         '<td align="right">'.$count.'</td>'.
                    304:                         '<td align="right">'.
                    305:                             sprintf("%.2f",$count/$total*100).'%</td>'.
                    306:                         '</tr>'.$/;
                    307:                 }
                    308:                 $Str .= '<tr>'.
                    309:                     '<th>'.&mt('Foil Name').'</th>'.
                    310:                     '<th>'.&mt('Text').'</th>'.
                    311:                     '<th>'.&mt('Freq').'</th>'.
                    312:                     '<th>'.&mt('Percent').'</th>'.
                    313:                     '</tr>'.$/.
                    314:                     $tmp;
                    315:             }
                    316:             $Str.= '</table><hr />';
                    317:             $r->print($Str);
                    318:             $r->rflush();
                    319:         }
                    320:     }
                    321:     return;
                    322: }
                    323: 
                    324: sub randomize_array {
                    325:     # Fisher Yates shuffle, lifted from p 121 of "The Perl Cookbook"
                    326:     my ($array) = @_;
                    327:     for (my $i=scalar(@$array);--$i;) {
                    328:         my $j = int(rand($i+1));
                    329:         next if ($i == $j);
                    330:         @$array[$i,$j]=@$array[$j,$i];
                    331:     }
                    332: }
                    333: 
                    334: #########################################################
                    335: #########################################################
                    336: ##
                    337: ##   Generic Interface Routines
                    338: ##
                    339: #########################################################
                    340: #########################################################
                    341: sub CreateInterface {
                    342:     ##
                    343:     ## Environment variable initialization
                    344:     my $Str = '';
                    345:     $Str .= &Apache::lonhtmlcommon::breadcrumbs
                    346:         (undef,'Student Submission Reports');
                    347:     $Str .= '<p>';
                    348:     $Str .= '<table cellspacing="5">'."\n";
                    349:     $Str .= '<tr>';
                    350:     $Str .= '<td align="center"><b>'.&mt('Sections').'</b></td>';
                    351:     $Str .= '<td align="center"><b>'.&mt('Enrollment Status').'</b></td>';
                    352:     $Str .= '</tr>'."\n";
                    353:     #
                    354:     $Str .= '<tr><td align="center">'."\n";
                    355:     $Str .= &Apache::lonstatistics::SectionSelect('Section','multiple',5);
                    356:     $Str .= '</td>';
                    357:     #
                    358:     $Str .= '<td align="center">';
                    359:     $Str .= &Apache::lonhtmlcommon::StatusOptions(undef,undef,5);
                    360:     $Str .= '</td>';
                    361:     #
                    362:     $Str .= '</tr>'."\n";
                    363:     $Str .= '</table>'."\n";
                    364:     #
                    365:     $Str .= '<nobr>'.&mt('Status: [_1]',
                    366:                          '<input type="text" '.
                    367:                          'name="stats_status" size="60" value="" />').
                    368:             '</nobr>'.'</p>';    
                    369:     ##
                    370:     return $Str;
                    371: }
                    372: 
                    373: 
                    374: 
                    375: 1;
                    376: 
                    377: __END__

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