[LON-CAPA-cvs] cvs: loncom /interface lonstatistics.pm /interface/statistics lonstathelpers.pm lonsurveyreports.pm doc/loncapafiles loncapafiles.lpml
matthew
lon-capa-cvs@mail.lon-capa.org
Tue, 15 Jun 2004 14:22:46 -0000
This is a MIME encoded message
--matthew1087309366
Content-Type: text/plain
matthew Tue Jun 15 10:22:46 2004 EDT
Added files:
/loncom/interface/statistics lonsurveyreports.pm
Modified files:
/doc/loncapafiles loncapafiles.lpml
/loncom/interface lonstatistics.pm
/loncom/interface/statistics lonstathelpers.pm
Log:
Added lonsurveyreports.pm - module to generate (currently only HTML) reports
of student answers to survey questions.
lonstatistics.pm: Added hooks to survey reports
lonstathelpers.pm: Modified &get_prev_curr_next to work on just surveys
loncapafiles.lpml: Added lonsurveyreports.pm
--matthew1087309366
Content-Type: text/plain
Content-Disposition: attachment; filename="matthew-20040615102246.txt"
Index: doc/loncapafiles/loncapafiles.lpml
diff -u doc/loncapafiles/loncapafiles.lpml:1.365 doc/loncapafiles/loncapafiles.lpml:1.366
--- doc/loncapafiles/loncapafiles.lpml:1.365 Mon Jun 14 12:43:35 2004
+++ doc/loncapafiles/loncapafiles.lpml Tue Jun 15 10:22:45 2004
@@ -2,7 +2,7 @@
"http://lpml.sourceforge.net/DTD/lpml.dtd">
<!-- loncapafiles.lpml -->
-<!-- $Id: loncapafiles.lpml,v 1.365 2004/06/14 16:43:35 www Exp $ -->
+<!-- $Id: loncapafiles.lpml,v 1.366 2004/06/15 14:22:45 matthew Exp $ -->
<!--
@@ -2647,6 +2647,15 @@
</description>
</file>
<file>
+<source>loncom/interface/statistics/lonsurveyreports.pm</source>
+<target dist='default'>home/httpd/lib/perl/Apache/lonsurveyreports.pm
+</target>
+<categoryname>Statistics Module</categoryname>
+<description>
+Gives instructors access to compiled survey results.
+</description>
+</file>
+<file>
<source>loncom/interface/statistics/lonstudentsubmissions.pm</source>
<target dist='default'>home/httpd/lib/perl/Apache/lonstudentsubmissions.pm
</target>
Index: loncom/interface/lonstatistics.pm
diff -u loncom/interface/lonstatistics.pm:1.103 loncom/interface/lonstatistics.pm:1.104
--- loncom/interface/lonstatistics.pm:1.103 Fri Jun 4 17:42:18 2004
+++ loncom/interface/lonstatistics.pm Tue Jun 15 10:22:45 2004
@@ -1,6 +1,6 @@
# The LearningOnline Network with CAPA
#
-# $Id: lonstatistics.pm,v 1.103 2004/06/04 21:42:18 matthew Exp $
+# $Id: lonstatistics.pm,v 1.104 2004/06/15 14:22:45 matthew Exp $
#
# Copyright Michigan State University Board of Trustees
#
@@ -77,6 +77,7 @@
use Apache::lonstudentassessment();
use Apache::lonpercentage;
use Apache::lonstudentsubmissions();
+use Apache::lonsurveyreports();
#######################################################
#######################################################
@@ -1055,6 +1056,11 @@
short_description =>
&mt('Prepare Excel spreadsheets of student submissions.'),
},
+ { internal_name => 'survey_reports',
+ name => &mt('Survey Reports'),
+ short_description =>
+ &mt('Prepare reports on survey results.'),
+ },
{ internal_name => 'correct_problems_plot',
name => &mt('Correct Problems Plot'),
short_description =>
@@ -1200,6 +1206,12 @@
'/adm/statistics?reportselected=student_submission_reports',
text=>'Student Submission Reports'});
&Apache::lonstudentsubmissions::BuildStudentSubmissionsPage($r,$c);
+ } elsif($GoToPage eq 'survey_reports') {
+ &Apache::lonhtmlcommon::add_breadcrumb
+ ({href=>
+ '/adm/statistics?reportselected=survey_reports',
+ text=>'Survey Reports'});
+ &Apache::lonsurveyreports::BuildSurveyReportsPage($r,$c);
} elsif($GoToPage eq 'correct_problems_plot') {
&Apache::lonhtmlcommon::add_breadcrumb
({href=>'/adm/statistics?reportselected=correct_problems_plot',
Index: loncom/interface/statistics/lonstathelpers.pm
diff -u loncom/interface/statistics/lonstathelpers.pm:1.12 loncom/interface/statistics/lonstathelpers.pm:1.13
--- loncom/interface/statistics/lonstathelpers.pm:1.12 Fri Jun 4 17:42:18 2004
+++ loncom/interface/statistics/lonstathelpers.pm Tue Jun 15 10:22:45 2004
@@ -1,6 +1,6 @@
# The LearningOnline Network with CAPA
#
-# $Id: lonstathelpers.pm,v 1.12 2004/06/04 21:42:18 matthew Exp $
+# $Id: lonstathelpers.pm,v 1.13 2004/06/15 14:22:45 matthew Exp $
#
# Copyright Michigan State University Board of Trustees
#
@@ -224,7 +224,7 @@
=pod
-=item &get_prev_curr_next($target)
+=item &get_prev_curr_next($target,$AcceptableResponseTypes,$granularity)
Determine the problem parts or responses preceeding and following the
current resource.
@@ -232,7 +232,7 @@
Inputs: $target (see &Apache::lonstathelpers::get_target_from_id())
$AcceptableResponseTypes, regular expression matching acceptable
response types,
- $granularity, either 'part' or 'response'
+ $granularity, either 'part', 'response', or 'part_survey'
Returns: three hash references, $prev, $curr, $next, which refer to the
preceeding, current, or following problem parts or responses, depending
@@ -260,7 +260,13 @@
next if ($res->{'type'} ne 'assessment');
foreach my $part (@{$res->{'parts'}}) {
my $partdata = $res->{'partdata'}->{$part};
- if ($granularity eq 'part') {
+ if ($granularity eq 'part_survey' && $partdata->{'Survey'}){
+ push (@Resource,
+ { symb => $res->{symb},
+ part => $part,
+ resource => $res,
+ } );
+ } elsif ($granularity eq 'part') {
push (@Resource,
{ symb => $res->{symb},
part => $part,
@@ -290,7 +296,7 @@
my $curr_idx;
for ($curr_idx=0;$curr_idx<$#Resource;$curr_idx++) {
my $curr_item = $Resource[$curr_idx];
- if ($granularity eq 'part') {
+ if ($granularity eq 'part' || $granularity eq 'part_survey') {
if ($curr_item->{'symb'} eq $target->{'symb'} &&
$curr_item->{'part'} eq $target->{'part'}) {
last;
@@ -305,7 +311,7 @@
}
}
my $curr_item = $Resource[$curr_idx];
- if ($granularity eq 'part') {
+ if ($granularity eq 'part' || $granularity eq 'part_survey') {
if ($curr_item->{'symb'} ne $target->{'symb'} ||
$curr_item->{'part'} ne $target->{'part'}) {
# bogus symb - return nothing
Index: loncom/interface/statistics/lonsurveyreports.pm
+++ loncom/interface/statistics/lonsurveyreports.pm
# The LearningOnline Network with CAPA
#
# $Id: lonsurveyreports.pm,v 1.1 2004/06/15 14:22:45 matthew Exp $
#
# Copyright Michigan State University Board of Trustees
#
# This file is part of the LearningOnline Network with CAPA (LON-CAPA).
#
# LON-CAPA is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; either version 2 of the License, or
# (at your option) any later version.
#
# LON-CAPA is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with LON-CAPA; if not, write to the Free Software
# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
#
# /home/httpd/html/adm/gpl.txt
#
# http://www.lon-capa.org/
#
package Apache::lonsurveyreports;
use strict;
use Apache::lonnet();
use Apache::loncommon();
use Apache::lonhtmlcommon();
use Apache::loncoursedata();
use Apache::lonstatistics;
use Apache::lonlocal;
use Apache::lonstathelpers;
use HTML::Entities();
use Time::Local();
my @SubmitButtons = ({ name => 'PrevProblem',
text => 'Previous Survey' },
{ name => 'NextProblem',
text => 'Next Survey' },
{ name => 'break'},
{ name => 'SelectAnother',
text => 'Choose a different Survey Problem' },
{ name => 'Generate',
text => 'Generate Report'},
);
sub BuildSurveyReportsPage {
my ($r,$c)=@_;
#
my %Saveable_Parameters = ('Status' => 'scalar',
'Section' => 'array',
'NumPlots' => 'scalar',
);
&Apache::loncommon::store_course_settings('survey_reports',
\%Saveable_Parameters);
&Apache::loncommon::restore_course_settings('survey_resports',
\%Saveable_Parameters);
#
&Apache::lonstatistics::PrepareClasslist();
#
$r->print(&CreateInterface());
#
my @Students = @Apache::lonstatistics::Students;
#
if (@Students < 1) {
$r->print('<h2>There are no students in the sections selected</h2>');
}
#
my @CacheButtonHTML =
&Apache::lonstathelpers::manage_caches($r,'Statistics','stats_status');
$r->rflush();
#
if (exists($ENV{'form.problemchoice'}) &&
! exists($ENV{'form.SelectAnother'})) {
foreach my $button (@SubmitButtons) {
if ($button->{'name'} eq 'break') {
$r->print("<br />\n");
} else {
$r->print('<input type="submit" name="'.$button->{'name'}.'" '.
'value="'.&mt($button->{'text'}).'" />');
$r->print(' 'x5);
}
}
foreach my $html (@CacheButtonHTML) {
$r->print($html.(' 'x5));
}
#
$r->print('<hr />');
$r->rflush();
#
# Determine which problem we are to analyze
my $current_problem = &Apache::lonstathelpers::get_target_from_id
($ENV{'form.problemchoice'});
#
my ($prev,$curr,$next) =
&Apache::lonstathelpers::get_prev_curr_next($current_problem,
'.',
'part_survey',
);
if (exists($ENV{'form.PrevProblem'}) && defined($prev)) {
$current_problem = $prev;
} elsif (exists($ENV{'form.NextProblem'}) && defined($next)) {
$current_problem = $next;
} else {
$current_problem = $curr;
}
#
# Store the current problem choice and send it out in the form
$ENV{'form.problemchoice'} =
&Apache::lonstathelpers::make_target_id($current_problem);
$r->print('<input type="hidden" name="problemchoice" value="'.
$ENV{'form.problemchoice'}.'" />');
#
if (! defined($current_problem->{'resource'})) {
$r->print('resource is undefined');
} else {
my $resource = $current_problem->{'resource'};
$r->print('<h1>'.$resource->{'title'}.'</h1>');
$r->print('<h3>'.$resource->{'src'}.'</h3>');
$r->print(&Apache::lonstathelpers::render_resource($resource));
$r->rflush();
my %Data = &Apache::lonstathelpers::get_problem_data
($resource->{'src'});
&make_HTML_report($r,$current_problem,\%Data,\@Students);
}
$r->print('<hr />');
} else {
$r->print('<input type="submit" name="Generate" value="'.
&mt('Generate Survey Report').'" />');
$r->print(' 'x5);
$r->print('<h3>'.&mt('Please select a Survey to analyze').'</h3>');
$r->print(&SurveyProblemSelector());
}
}
##########################################################
##########################################################
##
## SurveyProblemSelector
##
##########################################################
##########################################################
sub SurveyProblemSelector {
my $Str = '';
my @SurveyProblems;
foreach my $seq (&Apache::lonstatistics::Sequences_with_Assess('all')) {
next if ($seq->{'num_assess'}<1);
foreach my $res (@{$seq->{'contents'}}) {
next if ($res->{'type'} ne 'assessment');
foreach my $part (@{$res->{'parts'}}) {
if ($res->{'partdata'}->{$part}->{'Survey'}) {
push(@SurveyProblems,{res=>$res,seq=>$seq,part=>$part});
last;
}
}
}
}
if (! scalar(@SurveyProblems)) {
$Str = '<h1>'.
&mt('There are no survey problems in this course').
'</h1>'.$/;
return $Str;
}
$Str .= '<table>'.$/;
$Str .= '<tr>'.'<td></td>'.
'<th>'.&mt('Sequence').'</th>'.
'<th>'.&mt('Problem').'</th>'.
'</tr>'.$/;
foreach my $problem (@SurveyProblems) {
my $value = &Apache::lonstathelpers::make_target_id
({symb=>$problem->{'res'}->{'symb'},
part=>$problem->{'part'},
respid=>undef,
resptype=>undef});
my $checked = '';
if ($ENV{'form.problemchoice'} eq $value) {
$checked = 'checked ';
}
$Str .= '<tr>'.'<td>'.
'<input type="radio" name="problemchoice" '.
'value="'.$value.'" '.$checked.'/>'.'</td>'.
'<td>'.$problem->{'seq'}->{'title'}.'</td>'.
'<td>'.$problem->{'res'}->{'title'}.'</td>'.
'</tr>'.$/;
}
$Str .= '</table>';
return $Str;
}
#########################################################
#########################################################
##
## Compile Student Answers
##
#########################################################
#########################################################
sub Compile_Student_Answers {
my ($problem,$ProblemData,$Students) = @_;
my $resource = $problem->{'resource'};
foreach my $student (@$Students) {
foreach my $partid (@{$resource->{'parts'}}) {
my $partdata = $resource->{'partdata'}->{$partid};
for (my $i=0;$i<=@{$partdata->{'ResponseIds'}};$i++) {
my $respid = $partdata->{'ResponseIds'}->[$i];
my $resptype = $partdata->{'ResponseTypes'}->[$i];
my $results =
&Apache::loncoursedata::get_response_data_by_student
($student,$resource->{'symb'},$respid);
next if (! defined($results) || ref($results) ne 'ARRAY' ||
ref($results->[0]) ne 'ARRAY');
my $student_response =
$results->[0]->[&Apache::loncoursedata::RDs_submission()];
$problem->{'responsedata'}->{$partid}->{$respid}->{'_count'}++;
my $data = $problem->{'responsedata'}->{$partid}->{$respid};
if ($resptype =~ /^(radiobutton|optionresponse)$/) {
# Restricted response type can be categorized.
#
# Assume responses were not randomized and the order
# represents their value. This is probably a dumb thing
# to do...
#
my ($foil,$value) = split('=',$student_response);
$value += 1; # explicitly increment it...
$data->{'foil_responses'}->{$foil}++;
$data->{'foil_values'}->{$value}++;
if (! exists($data->{'map'}->{$value})) {
$data->{'map'}->{$value} = $foil;
}
} else {
# Variable stuff (essays, raw numbers, strings) go here
push(@{$data->{'responses'}},$student_response);
}
}
}
}
return;
}
#########################################################
#########################################################
##
## make_HTML_report
##
#########################################################
#########################################################
sub make_HTML_report {
my ($r,$problem,$ProblemData,$Students) = @_;
&Compile_Student_Answers($problem,$ProblemData,$Students);
# &output_hash('',$ProblemData);
my $resource = $problem->{'resource'};
foreach my $partid (@{$resource->{'parts'}}) {
my $partdata = $resource->{'partdata'}->{$partid};
for (my $i=0;$i<=@{$partdata->{'ResponseIds'}};$i++) {
my $Str = '<table>'.$/;
my $respid = $partdata->{'ResponseIds'}->[$i];
my $resptype = $partdata->{'ResponseTypes'}->[$i];
my $data = $problem->{'responsedata'}->{$partid}->{$respid};
next if (! defined($data) || ref($data) ne 'HASH');
# Debugging code
# $Str .= '<tr>'.
# '<td>'.$partid.'</td>'.
# '<td>'.$respid.'</td>'.
# '<td>'.$resptype.'</td>'.
# '</tr>'.$/;
$Str .= '<tr>'.
'<td><b>'.&mt('Total').'</b></td>'.
'<td>'.$data->{'_count'}.'</td>'.
'<td> </td>'.
'</tr>'.$/;
if (exists($data->{'responses'}) &&
ref($data->{'responses'}) eq 'ARRAY') {
&randomize_array($data->{'responses'});
foreach my $response (@{$data->{'responses'}}) {
$response =~ s/\\r\\n/\n/g;
$response =~ s/\\'/'/g;
$response =~ s/\\"/"/g;
$Str .= '<tr>'.
'<td colspan="3"><pre>'.
&HTML::Entities::encode($response,'<>&').
'</pre><hr /></td>'.
'</tr>'.$/;
}
} elsif (exists($data->{'_count'}) &&
exists($data->{'foil_values'}) &&
exists($data->{'map'})) {
# This is an option or radiobutton survey response
my $total = $data->{'_count'};
my $sum = 0;
my $tmp;
foreach my $value (sort(keys(%{$data->{'foil_values'}}))) {
my $count = $data->{'foil_values'}->{$value};
my $foilid = $data->{'map'}->{$value};
my $foiltext = $ProblemData->{$partid.'.'.$respid}->{'_Foils'}->{$foilid}->{'text'};
my $foilname = $ProblemData->{$partid.'.'.$respid}->{'_Foils'}->{$foilid}->{'name'};
$sum = $value * $data->{'foil_values'}->{$value};
$tmp .= '<tr>'.
'<td>'.$foilname.'</td>'.
'<td>'.$foiltext.'</td>'.
'<td align="right">'.$count.'</td>'.
'<td align="right">'.
sprintf("%.2f",$count/$total*100).'%</td>'.
'</tr>'.$/;
}
$Str .= '<tr>'.
'<td><b>'.&mt('mean').'</b></td>'.
'<td>'.sprintf("%.2f",$sum/$total).'</td>'.
'<td> </td>'.
'<td> </td>'.
'</tr>'.$/.
'<tr>'.
'<th>'.&mt('Foil Name').'</th>'.
'<th>'.&mt('Text').'</th>'.
'<th>'.&mt('Freq').'</th>'.
'<th>'.&mt('Percent').'</th>'.
'</tr>'.$/.
$tmp;
}
$Str.= '</table><hr />';
$r->print($Str);
$r->rflush();
}
}
return;
}
sub randomize_array {
# Fisher Yates shuffle, lifted from p 121 of "The Perl Cookbook"
my ($array) = @_;
for (my $i=scalar(@$array);--$i;) {
my $j = int(rand($i+1));
next if ($i == $j);
@$array[$i,$j]=@$array[$j,$i];
}
}
#########################################################
#########################################################
##
## Generic Interface Routines
##
#########################################################
#########################################################
sub CreateInterface {
##
## Environment variable initialization
my $Str = '';
$Str .= &Apache::lonhtmlcommon::breadcrumbs
(undef,'Student Submission Reports');
$Str .= '<p>';
$Str .= '<table cellspacing="5">'."\n";
$Str .= '<tr>';
$Str .= '<td align="center"><b>'.&mt('Sections').'</b></td>';
$Str .= '<td align="center"><b>'.&mt('Enrollment Status').'</b></td>';
$Str .= '</tr>'."\n";
#
$Str .= '<tr><td align="center">'."\n";
$Str .= &Apache::lonstatistics::SectionSelect('Section','multiple',5);
$Str .= '</td>';
#
$Str .= '<td align="center">';
$Str .= &Apache::lonhtmlcommon::StatusOptions(undef,undef,5);
$Str .= '</td>';
#
$Str .= '</tr>'."\n";
$Str .= '</table>'."\n";
#
$Str .= '<nobr>'.&mt('Status: [_1]',
'<input type="text" '.
'name="stats_status" size="60" value="" />').
'</nobr>'.'</p>';
##
return $Str;
}
1;
__END__
--matthew1087309366--