File:  [LON-CAPA] / loncom / interface / statistics / lonproblemanalysis.pm
Revision 1.35: download - view: text, annotated - select for diffs
Tue Oct 14 14:23:14 2003 UTC (20 years, 8 months ago) by matthew
Branches: MAIN
CVS tags: HEAD
Minor code cleanup.  Additionally, most humans begin enumerating with 1, not 0,
so the first graph is now called 'plot 1' not 'plot 0'.

# The LearningOnline Network with CAPA
#

# $Id: lonproblemanalysis.pm,v 1.35 2003/10/14 14:23:14 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::lonproblemanalysis;

use strict;
use Apache::lonnet();
use Apache::loncommon();
use Apache::lonhtmlcommon();
use Apache::loncoursedata();
use Apache::lonstatistics;
use Apache::lonlocal;

sub BuildProblemAnalysisPage {
    my ($r,$c)=@_;
    $r->print('<h2>'.&mt('Option Response Problem Analysis').'</h2>');
    $r->print(&CreateInterface());
    #
    my @Students = @Apache::lonstatistics::Students;
    #
    if (exists($ENV{'form.updatecaches'}) ||
        (exists($ENV{'form.firstanalysis'}) &&
         $ENV{'form.firstanalysis'} ne 'no')) {
        &Apache::lonstatistics::Gather_Full_Student_Data($r);
    }
    if (! exists($ENV{'form.firstanalysis'})) {
        $r->print('<input type="hidden" name="firstanalysis" value="yes" />');
    } else {
        $r->print('<input type="hidden" name="firstanalysis" value="no" />');
    }
    if (exists($ENV{'form.problemchoice'}) && 
        ! exists($ENV{'form.SelectAnother'})) {
        $r->print('<input type="submit" name="ProblemAnalysis" value="'.
                  &mt('Analyze Problem Again').'" />');
        $r->print('&nbsp;'x5);
        $r->print('<input type="submit" name="ClearCache" value="'.
                  &mt('Clear Caches').'" />');
        $r->print('&nbsp;'x5);
        $r->print('<input type="submit" name="updatecaches" value="'.
                  &mt('Update Student Data').'" />');
        $r->print('&nbsp;'x5);
        $r->print('<input type="hidden" name="problemchoice" value="'.
                  $ENV{'form.problemchoice'}.'" />');
        $r->print('<input type="submit" name="SelectAnother" value="'.
                  &mt('Choose a different resource').'" />');
        $r->print('&nbsp;'x5);
        #
        $r->print('<hr />');
        #
        my ($symb,$part,$resid) = &get_problem_symb(
                     &Apache::lonnet::unescape($ENV{'form.problemchoice'})
                                           );
        #
        my $resource = &get_resource_from_symb($symb);
        if (defined($resource)) {
            my %Data = &get_problem_data($resource->{'src'});
            my $ORdata = $Data{$part.'.'.$resid};
            ##
            ## Render the problem
            my $base;
            ($base,undef) = ($resource->{'src'} =~ m|(.*/)[^/]*$|);
            $base = "http://".$ENV{'SERVER_NAME'}.$base;
            my $rendered_problem = 
                &Apache::lonnet::ssi_body($resource->{'src'});
            $rendered_problem =~ s/<\s*form\s*/<nop /g;
            $rendered_problem =~ s|(<\s*/form\s*>)|<\/nop>|g;
            $r->print('<table bgcolor="ffffff"><tr><td>'.
                      '<base href="'.$base.'" />'.
                      $rendered_problem.
                      '</td></tr></table>');
            ##
            ## Analyze the problem
            my $PerformanceData = 
                &Apache::loncoursedata::get_optionresponse_data
                                           (\@Students,$symb,$resid);
            if (defined($PerformanceData) && 
                ref($PerformanceData) eq 'ARRAY') {
                if ($ENV{'form.AnalyzeBy'} eq 'Tries') {
                    my $analysis_html = &tries_analysis($PerformanceData,
                                                         $ORdata);
                    $r->print($analysis_html);
                } elsif ($ENV{'form.AnalyzeBy'} eq 'Time') {
                    my $analysis_html = &time_analysis($PerformanceData,
                                                         $ORdata);
                $r->print($analysis_html);
                } else {
                    $r->print('<h2>'.
                              &mt('The analysis you have selected is '.
                                         'not supported at this time').
                              '</h2>');
                }
            } else {
                $r->print('<h2>'.
                          &mt('There is no student data for this problem.').
                          '</h2>');
            }
        } else {
            $r->print('resource is undefined');
        }
        $r->print('<hr />');
    } else {
        $r->print('<input type="submit" name="ProblemAnalysis" value="'.
                  &mt('Analyze Problem').'" />');
        $r->print('&nbsp;'x5);
        $r->print('<h3>'.&mt('Please select a problem to analyze').'</h3>');
        $r->print(&OptionResponseProblemSelector());
    }
}


#########################################################
#########################################################
##
##      Misc interface routines use by analysis code
##
#########################################################
#########################################################
sub build_foil_index {
    my ($ORdata) = @_;
    my @Foils = sort(keys(%{$ORdata->{'Foiltext'}}));
    my %Row_Label;
    foreach my $foilid (@Foils) {
        my $value = $ORdata->{'Foiltext'}->{$foilid};
        $Row_Label{$foilid} = $ORdata->{'Foiltext'}->{$foilid};
    }
    #
    # Build up the table of row labels.
    my $table = '<table border="1" >'."\n";
    $table .= '<tr><th>'.&mt('Foil Number').'</th>'.
        '<th>'.&mt('Foil Text')."</th></tr>\n";
    my $index = 1;
    foreach my $foilid (@Foils) {
        $table .= '<tr><td>'.$index.'</td>'.
            '<td>'.$Row_Label{$foilid}."</td></tr>\n";
    } continue {
        $index++;
    }
    $table .= "</table>\n";
    return ($table,@Foils);
}

#########################################################
#########################################################
##
##         Tries Analysis
##
#########################################################
#########################################################
sub tries_analysis {
    my ($PerformanceData,$ORdata) = @_;
    my $mintries = 1;
    my $maxtries = $ENV{'form.NumPlots'};
    my %ResponseData = &analyze_option_data_by_tries($PerformanceData,
                                                 $mintries,$maxtries);
    my ($table,@Foils) = &build_foil_index($ORdata);
    #
    # Compute the data neccessary to make the plots
    my @PlotData;
    my @CumulativePlotData;
    foreach my $foilid (@Foils) {
        for (my $i=$mintries;$i<=$maxtries;$i++) {
            #
            # Gather the per-attempt data
            push (@{$PlotData[$i]->{'good'}},
                  $ResponseData{$foilid}->[$i]->{'percent_corr'});
            push (@{$PlotData[$i]->{'bad'}},
                  100-$ResponseData{$foilid}->[$i]->{'percent_corr'});
            #
            # Someday we may need the cumulative data and I think
            # this is a neat way of computing it as we go along.
            push (@{$CumulativePlotData[$i]->{'good'}},
                  $CumulativePlotData[-1]->{'good'}+
                  $ResponseData{$foilid}->[$i]->{'correct'});
            push (@{$CumulativePlotData[$i]->{'bad'}},
                  $CumulativePlotData[-1]->{'bad'}+
                  $ResponseData{$foilid}->[$i]->{'incorrect'});
        }
    }
    # 
    # Build a table for the plots
    $table .= "<table>\n";
    my @Plots;
    for (my $i=$mintries;$i<=$maxtries;$i++) {
        my $minstu = $ResponseData{$Foils[0]}->[$i]->{'total'};
        my $maxstu = $ResponseData{$Foils[0]}->[$i]->{'total'};
        foreach my $foilid (@Foils) {
            if ($minstu > $ResponseData{$foilid}->[$i]->{'total'}) {
                $minstu = $ResponseData{$foilid}->[$i]->{'total'};
            }
            if ($maxstu < $ResponseData{$foilid}->[$i]->{'total'}) {
                $maxstu = $ResponseData{$foilid}->[$i]->{'total'};
            }
        }
        $maxstu = 0 if (! $maxstu);
        $minstu = 0 if (! $minstu);
        my $title;
        if ($maxstu == $minstu) {
            $title = 'Attempt '.$i.', '.$maxstu.' students';
        } else {
            $title = 'Attempt '.$i.', '.$minstu.'-'.$maxstu.' students';
        }
        my $graphlink = &Apache::loncommon::DrawGraph($title,
                                                      'Foil Number',
                                                      'Percent Correct',
                                                      100,
                                                      $PlotData[$i]->{'good'},
                                                      $PlotData[$i]->{'bad'});
        push(@Plots,$graphlink);
    }
    #
    # Should this be something the user can set?  Too many dialogs!
    my $plots_per_row = 2;
    while (my $plotlink = shift(@Plots)) {
        $table .= '<tr><td>'.$plotlink.'</td>';
        for (my $i=1;$i<$plots_per_row;$i++) {
            if ($plotlink = shift(@Plots)) {
                $table .= '<td>'.$plotlink.'</td>';
            } else {
                $table .= '<td></td>';
            }
        }
        $table .= "</tr>\n";
    }
    $table .= "</table>\n";
    return ($table);
}

sub analyze_option_data_by_tries {
    my ($PerformanceData,$mintries,$maxtries) = @_;
    my %Trydata;
    $mintries = 1         if (! defined($mintries) || $mintries < 1);
    $maxtries = $mintries if (! defined($maxtries) || $maxtries < $mintries);
    foreach my $row (@$PerformanceData) {
        next if (! defined($row));
        my ($grading,$submission,$time,$tries) = @$row;
        my @Foilgrades = split('&',$grading);
        my @Foilsubs   = split('&',$submission);
        for (my $numtries = 1; $numtries <= $maxtries; $numtries++) {
            if ($tries == $numtries) {
                foreach my $foilgrade (@Foilgrades) {
                    my ($foilid,$correct) = split('=',$foilgrade);
                    if ($correct) {
                        $Trydata{$foilid}->[$numtries]->{'correct'}++;
                    } else {
                        $Trydata{$foilid}->[$numtries]->{'incorrect'}++;
                    }                        
                }
            }
        }
    }
    foreach my $foilid (keys(%Trydata)) {
        foreach my $tryhash (@{$Trydata{$foilid}}) {
            next if ((! exists($tryhash->{'correct'}) && 
                      ! exists($tryhash->{'incorrect'})) ||
                     ($tryhash->{'correct'} < 1 &&
                      $tryhash->{'incorrect'} < 1));
            $tryhash->{'total'} = $tryhash->{'correct'} + 
                                        $tryhash->{'incorrect'};
            $tryhash->{'percent_corr'} = 100 *
                ($tryhash->{'correct'} /
                         ($tryhash->{'correct'} + $tryhash->{'incorrect'})
                 );
        }
    }
    return %Trydata;
}

#########################################################
#########################################################
##
##                 Time Analysis
##
#########################################################
#########################################################
sub time_analysis {
    my ($PerformanceData,$ORdata) = @_;
    my $num_plots = $ENV{'form.NumPlots'};
    my ($table,@Foils) = &build_foil_index($ORdata);
    my $num_data = scalar(@$PerformanceData)-1;
    my $percent = sprintf('%2f',100/$num_plots);
    for (my $i=0;$i<$num_plots;$i++) {
        my $starttime = &Apache::lonhtmlcommon::get_date_from_form
            ('startdate_'.$i);
        my $endtime = &Apache::lonhtmlcommon::get_date_from_form
            ('enddate_'.$i);
        my ($begin_index,$end_index,$plottitle,$plothtml,$data);
        if (! defined($starttime) || ! defined($endtime)) {
            $begin_index = $i*int($num_data/$num_plots);
            $end_index = ($i+1)*int($num_data/$num_plots);
            my $lownum  = sprintf('%2.1f',$i*$percent);
            $lownum =~ s/(\.0)$//;
            my $highnum = sprintf('%2.1f',($i+1)*$percent);
            $highnum =~ s/(\.0)$//;
            $plottitle = $lownum.'% to '.$highnum.'% of submissions';
        } else {
            my $j;
            while (++$j < scalar(@$PerformanceData)) {
                last if ($PerformanceData->[$j]->[2] > $starttime);
            }
            $begin_index = $j;
            while (++$j < scalar(@$PerformanceData)) {
                last if ($PerformanceData->[$j]->[2] > $endtime);
            }
            $end_index = $j;
            $plottitle = 'Tries plot '.($i+1);
        }

        ($plothtml,$starttime,$endtime,$data) = 
            &analyze_option_data_by_time($PerformanceData,
                                         $begin_index,$end_index,
                                         $plottitle,
                                         @Foils);
        my $startdateform = &Apache::lonhtmlcommon::date_setter
            ('Statistics','startdate_'.$i,$starttime);
        my $enddateform = &Apache::lonhtmlcommon::date_setter
            ('Statistics','enddate_'.$i,$endtime);
        $plothtml.= "<br />\n".
            "<b>Start Time</b>: "."&nbsp;".$startdateform."<br />\n".
            "<b>End Time</b>&nbsp;&nbsp;: "."&nbsp;".$enddateform."<br />\n";
        $table.=$plothtml;
    }
    return $table;
}

sub analyze_option_data_by_time {
    my ($PerformanceData,$begin_index,$end_index,$description,@Foils) = @_;
    my %TimeData;
    #
    # Get the start and end times for this segment of the plot
    my $starttime = $PerformanceData->[$begin_index]->[2];
    my $endtime   = $PerformanceData->[$end_index  ]->[2];
    #
    # Compute the number getting the foils correct or incorrects
    for (my $i=$begin_index;$i<=$end_index;$i++) {
        my $row = $PerformanceData->[$i];
        next if (! defined($row));
        my ($grading,$submission,$time,$tries) = @$row;
        my @Foilgrades = split('&',$grading);
        my @Foilsubs   = split('&',$submission);
        foreach my $foilgrade (@Foilgrades) {
            my ($foilid,$correct) = split('=',$foilgrade);
            if ($correct) {
                $TimeData{$foilid}->{'correct'}++;
            } else {
                $TimeData{$foilid}->{'incorrect'}++;
            }
        }
    }
    #
    # Compute the total and percent correct
    my @Plotdata1;
    my @Plotdata2;
    foreach my $foilid (@Foils) {
        if (! exists($TimeData{$foilid}->{'correct'})) {
            $TimeData{$foilid}->{'correct'} = 0;
        }
        if (! exists($TimeData{$foilid}->{'incorrect'})) {
            $TimeData{$foilid}->{'incorrect'} = 0;
        }
        $TimeData{$foilid}->{'total'} = $TimeData{$foilid}->{'correct'} +
                                $TimeData{$foilid}->{'incorrect'};
        $TimeData{$foilid}->{'percent_corr'} = 100 *
            $TimeData{$foilid}->{'correct'} / 
            $TimeData{$foilid}->{'total'};
        push (@Plotdata1,    $TimeData{$foilid}->{'percent_corr'});
        push (@Plotdata2,100-$TimeData{$foilid}->{'percent_corr'});
    }
    #
    # Create the plot
    my $graphlink = &Apache::loncommon::DrawGraph
        ($description,#'Time Interval Analysis',
         'Foil Number',
         'Percent Correct / Incorrect',
         100,
         \@Plotdata1,\@Plotdata2);
    #
    return ($graphlink,$starttime,$endtime,\%TimeData);
}




#########################################################
#########################################################
##
##             Interface 
##
#########################################################
#########################################################
sub CreateInterface {
    ##
    ## Environment variable initialization
    if (! exists$ENV{'form.AnalyzeBy'}) {
        $ENV{'form.AnalyzeBy'} = 'Tries';
    }
    ##
    ## Build the menu
    my $Str = '';
    $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 .= '<td align="center"><b>'.&mt('Sequences and Folders').'</b></td>';
    $Str .= '<td align="center">&nbsp;</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 .= '<td align="center">';
    my $only_seq_with_assessments = sub { 
        my $s=shift;
        if ($s->{'num_assess'} < 1) { 
            return 0;
        } else { 
            return 1;
        }
    };
    &Apache::lonstatistics::MapSelect('Maps','multiple,all',5,
                                              $only_seq_with_assessments);
#    $Str .= '</td>';
    #
    $Str .= '<td>';
    $Str .= '<nobr>'.&mt('Analyze By ');
    $Str .='<select name="AnalyzeBy" >';
    #
    $Str .= '<option value="Tries" ';
    if (! exists($ENV{'form.AnalyzeBy'}) || $ENV{'form.AnalyzeBy'} eq 'Tries'){
        # Default to Tries
        $Str .= ' selected ';
    }
    $Str .= '>'.&mt('Tries').'</option>';
    #
    $Str .= '<option value="Time" ';
    $Str .= ' selected ' if ($ENV{'form.AnalyzeBy'} eq 'Time');
    $Str .= '>'.&mt('Time').'</option>';
    $Str .= '</select></nobr><br />';
    #
    $Str .= '<br /><nobr>'.&mt('Number of Plots:');
    $Str .= '<select name="NumPlots">';
    if (! exists($ENV{'form.NumPlots'}) 
        || $ENV{'form.NumPlots'} < 1 
        || $ENV{'form.NumPlots'} > 20) {
        $ENV{'form.NumPlots'} = 5;
    }
    foreach my $i (1,2,3,4,5,6,7,8,10,15,20) {
        $Str .= '<option value="'.$i.'" ';
        if ($ENV{'form.NumPlots'} == $i) { $Str.=' selected '; }
        $Str .= '>'.$i.'</option>';
    }
    $Str .= '</select></nobr>';
    $Str .= '</td>';
    #
    $Str .= '</tr>'."\n";
    $Str .= '</table>'."\n";
    return ($Str);
}

sub OptionResponseProblemSelector {
    my $Str;
    $Str = "\n<table>\n";
    foreach my $seq (&Apache::lonstatistics::Sequences_with_Assess()) {
        next if ($seq->{'num_assess'}<1);
        my $seq_str = '';
        foreach my $res (@{$seq->{'contents'}}) {
#            &Apache::lonnet::logthis('checking '.$res->{'title'});
            next if ($res->{'type'} ne 'assessment');
            foreach my $part (@{$res->{'parts'}}) {
                my $partdata = $res->{'partdata'}->{$part};
                if (! exists($partdata->{'option'}) || 
                    $partdata->{'option'} == 0) {
                    next;
                }
                for (my $i=0;$i<scalar(@{$partdata->{'ResponseTypes'}});$i++){
                    my $respid = $partdata->{'ResponseIds'}->[$i];
                    my $resptype = $partdata->{'ResponseTypes'}->[$i];
                    if ($resptype eq 'option') {
                        my $value = &Apache::lonnet::escape($res->{'symb'}.':'.$part.':'.$respid);
                        my $checked = '';
                        if ($ENV{'form.problemchoice'} eq $value) {
                            $checked = 'checked ';
                        }
                        $seq_str .= '<tr><td>'.
  '<input type="radio" name="problemchoice" value="'.$value.'" '.$checked.'/>'.
  '</td><td>'.
  '<a href="'.$res->{'src'}.'">'.$res->{'title'}.'</a> ';
                        if ($partdata->{'option'} > 1) {
                            $seq_str .= &mt('response').' '.$respid;
                        }
                        $seq_str .= "</td></tr>\n";
                    }
                }
            }
        }
        if ($seq_str ne '') {
            $Str .= '<tr><td>&nbsp</td><td><b>'.$seq->{'title'}.'</b></td>'.
                "</tr>\n".$seq_str;
        }
    }
    $Str .= "</table>\n";
    return $Str;
}

#########################################################
#########################################################
##
##              Misc functions
##
#########################################################
#########################################################
sub get_problem_symb {
    my $problemstring = shift();
    my ($symb,$partid,$resid) = ($problemstring=~ /^(.*):([^:]*):([^:]*)$/);
    return ($symb,$partid,$resid);
}

sub get_resource_from_symb {
    my ($symb) = @_;
    foreach my $seq (&Apache::lonstatistics::Sequences_with_Assess()) {
        foreach my $res (@{$seq->{'contents'}}) {
            if ($res->{'symb'} eq $symb) {
                return $res;
            }
        }
    }
    return undef;
}

sub get_problem_data {
    my ($url) = @_;
#    my $Answ=&Apache::lonnet::ssi($URI,('grade_target' => 'analyze',
#                                  'grade_username' => $sname,
#                                  'grade_domain' => $sdom,
#                                  'grade_courseid' => $cid,
#                                  'grade_symb' => $symb));
    my $Answ=&Apache::lonnet::ssi($url,('grade_target' => 'analyze'));
    (my $garbage,$Answ)=split(/_HASH_REF__/,$Answ,2);
    my %Answer;
    %Answer=&Apache::lonnet::str2hash($Answ);
#    &Apache::lonnet::logthis('keys of %Answer = '.join(', ',(keys(%Answer))));
#    &Apache::lonnet::logthis('$Answer{parts} = '.
#                             join(', ',@{$Answer{'parts'}}));
    my %Partdata;
    foreach my $part (@{$Answer{'parts'}}) {
        while (my($key,$value) = each(%Answer)) {
            next if ($key !~ /^$part/);
            $key =~ s/^$part\.//;
            if (ref($value) eq 'ARRAY') {
                if ($key eq 'options') {
                    $Partdata{$part}->{'Options'}=$value;
                } elsif ($key eq 'concepts') {
                    $Partdata{$part}->{'Concepts'}=$value;
                } elsif ($key =~ /^concept\.(.*)$/) {
                    my $concept = $1;
                    foreach my $foil (@$value) {
                        $Partdata{$part}->{$foil}->{'Concept'}=$concept;
                    }
                }
 #               &Apache::lonnet::logthis($part.' '.$key.' (array) = '.
 #                                        join(', ',@$value));
            } else {
                $value =~ s/^\s*//g;
                $value =~ s/\s*$//g;
                if ($key=~ /^foil\.text\.(.*)$/) {
                    my $foil = $1;
                    $Partdata{$part}->{'Foiltext'}->{$foil}=$value;
                } elsif ($key =~ /^foil\.value\.(.*)$/) {
                    my $foil = $1;
                    $Partdata{$part}->{'FoilValues'}->{$foil}=$value;
                }
#                &Apache::lonnet::logthis($part.' '.$key.' = '.$value);
            }
        }
    }

#    my $parts='';
#    foreach my $elm (@{$Answer{"parts"}}) {
#        $parts.="$elm,";
#    }
#    chop($parts);
#    my $conc='';
#    foreach my $elm (@{$Answer{"$parts.concepts"}}) {
#        $conc.="$elm@";
#    }
#    chop($conc);
#
#    @Concepts=split(/\@/,$conc);
#    foreach my $concept (@{$Answer{"$parts.concepts"}}) {
#        foreach my $foil (@{$Answer{"$parts.concept.$concept"}}) {
#            $foil_to_concept{$foil} = $concept;
#            #$ConceptData{$foil} = $Answer{"$parts.foil.value.$foil"};
#        }
#    }
#    return $symb;
    return %Partdata;
}

1;

__END__

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