';
+ $Str .= 'No Students enrolled OR Please select a student';
$r->print($Str);
+ } else {
+ if(tie(%cache,'GDBM_File',$cacheDB,&GDBM_READER(),0640)) {
+ $r->print(&StudentAverageTotal(\%cache, $students, $sequenceKeys));
+ untie(%cache);
+ }
}
-
return;
}
+#######################################################
+#######################################################
+
+=pod
+
+=item &CreateInterface()
+
+Called by &BuildStudentAssessmentPage to create the top part of the
+page which displays the chart.
+
+Inputs:
+
+=over 4
-#---- Student Assessment Web Page --------------------------------------------
+=item $cache The ubiquitous cache
+=item $selectedName The name of the currently selected student, or
+'All Students' or 'No Student Selected'.
+
+=item $students Array ref containing the name(s) of the students selected
+for display.
+
+=item $formName The name of the HTML form to use, 'Statistics'
+
+=item $doNotShow Array ref containing the names of columns to not show
+
+=back
+
+Returns: A string containing the HTML for the headers and top table for
+the chart page.
+
+=cut
+
+#######################################################
+#######################################################
sub CreateInterface {
my($cache,$selectedName,$students,$formName,$doNotShow)=@_;
@@ -193,9 +280,9 @@ sub CreateInterface {
$Str .= ''."\n";
- $Str .= &Apache::lonhtmlcommon::CreateHeadings($cache,
+ $Str .= &Apache::lonhtmlcommon::CreateHeadings($cache,
$infoKeys,
$infoHeadings,
$displayString,
@@ -259,38 +396,39 @@ sub CreateTableHeadings {
return $Str;
}
+#######################################################
+#######################################################
+
=pod
-=item &FormatStudentData()
+=item &StudentReport()
+
+This is the workhorse subroutine - it handles formatting and display of a
+students performance data. It processes one row of the chart.
-First, FormatStudentInformation is called and prefixes the course information.
-This function produces a formatted string of the student's course information.
-Each column of data represents all the problems for a given sequence. For
-valid grade data, a link is created for that problem to a submission record
-for that problem.
+Input:
=over 4
-Input: $name, $studentInformation, $ChartDB
+=item $cache The ubiquitous cache
-$name: The name and domain of the current student in name:domain format
+=item $name The name and domain of the current student in name:domain format
-$studentInformation: A pointer to an array holding the names used to
-remove data from the hash. They represent
-the name of the data to be removed.
+=item $spacing A string containing spaces.
-$ChartDB: The name of the cached data database which will be tied to that
-database.
+=item $showSequences Array ref containing the sequences to display
+
+=back
Output: $Str
-$Str: Formatted string that is an entire row of the chart. It is a
+$Str: Formatted string that is an entire row of the chart. It is a
concatenation of student information and student course information.
-=back
-
=cut
+#######################################################
+#######################################################
sub StudentReport {
my ($cache,$name,$spacing,$showSequences)=@_;
my ($username,$domain)=split(':',$name);
@@ -326,23 +464,27 @@ sub StudentReport {
}
$hasVersion = 'true';
$hasData = 'true';
- $Str .= '';
+ if (lc($ENV{'form.displaymode'}) ne 'display without links') {
+ $Str .= '';
+ }
my $code = $cache->{$name.':'.$problemID.':'.$_.':code'};
my $tries = $cache->{$name.':'.$problemID.':'.$_.':tries'};
if($code eq '*' && $tries < 10 && $tries ne '') {
$code = $tries;
}
$Str .= $code;
- $Str .= '';
+ if (lc($ENV{'form.displaymode'}) ne 'display without links') {
+ $Str .= '';
+ }
$characterCount++;
}
}
# Output the number of correct answers for the current sequence.
- # This part takes up 6 character slots, but is formated right
+ # This part takes up 6 character slots, but is formated right
# justified.
my $spacesNeeded=$cache->{$sequence.':columnWidth'}-$characterCount;
$spacesNeeded -= 3;
@@ -352,7 +494,7 @@ sub StudentReport {
# ':problemsCorrect'});
my $outputProblemsCorrect = sprintf("%2d/%2d", $cache->{$name.':'.$sequence.
- ':problemsCorrect'},
+ ':problemsCorrect'},
$characterCount);
if($hasData eq 'true') {
$Str .= ''.$outputProblemsCorrect.'';
@@ -382,6 +524,98 @@ sub StudentReport {
return $Str;
}
+#######################################################
+#######################################################
+
+#######################################################
+#######################################################
+sub StudentAverageTotal {
+ my ($cache, $students, $sequenceKeys)=@_;
+ my $Str = "\nSummary Tables:\n";
+ my %Correct = ();
+ my $ProblemsSolved = 0;
+ my $TotalProblems = 0;
+ my $StudentCount = 0;
+
+ foreach my $name (@$students) {
+ $StudentCount++;
+ foreach my $sequence (@$sequenceKeys) {
+ $Correct{$sequence} +=
+ $cache->{$name.':'.$sequence.':problemsCorrect'};
+ }
+ $ProblemsSolved += $cache->{$name.':problemsSolved'};
+ $TotalProblems += $cache->{$name.':totalProblems'};
+ }
+ if ($StudentCount) {
+ $ProblemsSolved = sprintf( "%.2f",
+ $ProblemsSolved/$StudentCount);
+ $TotalProblems /= $StudentCount;
+ } else {
+ $ProblemsSolved = 0;
+ $TotalProblems = 0;
+ }
+
+ $Str .= '
'."\n";
+ $Str .= '
Students Count
'.
+ $StudentCount.'
'."\n";
+ $Str .= '
Total Problems
'.
+ $TotalProblems.'
'."\n";
+ $Str .= '
Average Correct
'.
+ $ProblemsSolved.'
'."\n";
+ $Str .= '
'."\n";
+
+ $Str .= '
'."\n";
+ $Str .= '
Title
Total Problems
'.
+ '
Average Correct
'."\n";
+ foreach my $S(@$sequenceKeys) {
+ my $title=$cache->{$S.':title'};
+ #$Str .= $cache->{$S.':problems'};
+ #my @problems=split(':', $cache->{$S.':problems'});
+ #my $pCount=scalar @problems;
+ my $pCount=MaxSeqPr($cache,@$students[0],$S);
+ my $crr;
+ if ($StudentCount) {
+ $crr=sprintf( "%.2f", $Correct{$S}/$StudentCount );
+ } else {
+ $crr="0.00";
+ }
+ $Str .= '
".
" 1 correct by student in 1 try\n".
" 7 correct by student in 7 tries\n".
" * correct by student in more than 9 tries\n".
- " + correct by override\n".
+ " + correct by hand grading or override\n".
" - incorrect by override\n".
" . incorrect attempted\n".
" # ungraded attempted\n".
" not attempted (blank field)\n".
" x excused".
- "
";
+ "
";
return $Str;
}
+#######################################################
+#######################################################
+
=pod
=item &CreateColumnSelectionBox()
If there are columns not being displayed then this selection box is created
-with a list of those columns. When selections are made and the page
+with a list of those columns. When selections are made and the page
refreshed, the columns will be removed from this box and the column is
put back in the chart. If there is no columns to select, no row is added
to the interface table.
@@ -420,22 +659,23 @@ to the interface table.
=over 4
Input: $CacheData, $headings
-
$CacheData: A pointer to a hash tied to the cached data
-$headings: An array of the names of the columns for the student information.
+$headings: An array of the names of the columns for the student information.
They are used for displaying which columns are missing.
Output: $notThere
-$notThere: The string contains one row of a table. The first column has the
-name of the selection box. The second contains the selection box
+$notThere: The string contains one row of a table. The first column has the
+name of the selection box. The second contains the selection box
which has a size of four.
=back
=cut
+#######################################################
+#######################################################
sub CreateColumnSelectionBox {
my ($doNotShow)=@_;
@@ -455,11 +695,14 @@ sub CreateColumnSelectionBox {
return $notThere;
}
+#######################################################
+#######################################################
+
=pod
=item &CreateColumnSelectors()
-This function generates the checkboxes above the column headings. The
+This function generates the checkboxes above the column headings. The
column will be removed if the checkbox is unchecked.
=over 4
@@ -481,6 +724,8 @@ for consistency of location over the col
=cut
+#######################################################
+#######################################################
sub CreateColumnSelectors {
my ($infoHeadings, $sequenceHeadings, $sequenceKeys)=@_;
@@ -502,14 +747,25 @@ sub CreateColumnSelectors {
return $present;
}
-#---- END Student Assessment Web Page ----------------------------------------
+#######################################################
+#######################################################
-#---- Student Assessment Worker Functions ------------------------------------
+=pod
+
+=back
+
+=head1 HELPER FUNCTIONS
+=over 4
+
+=cut
+
+#######################################################
+#######################################################
sub FindSelectedStudent {
my($cache, $selectedName, $students)=@_;
- if($selectedName eq 'All Students' ||
+ if($selectedName eq 'All Students' ||
$selectedName eq 'No Student Selected') {
return $selectedName;
}
@@ -543,6 +799,8 @@ sub FindSelectedStudent {
return 'No Student Selected';
}
+#######################################################
+#######################################################
=pod
@@ -559,12 +817,12 @@ $cache: A pointer to the hash tied to th
$test: The form name of the column (heading.$headingIndex) or
(sequence.$sequenceIndex)
-Output: 0 (false), 1 (true)
-
=back
=cut
+#######################################################
+#######################################################
sub ShouldShowColumns {
my ($cache,$headings,$cacheKey)=@_;
@@ -593,7 +851,7 @@ sub ShouldShowColumns {
foreach my $sequence (split(/\:/,$cache->{'orderedSequences'})) {
$check = 'SequenceColumn'.$sequence;
- if($cache->{'SequencesFound'} eq 'All Sequences' ||
+ if($cache->{'SequencesFound'} eq 'All Sequences' ||
$cache->{'SequencesFound'} =~ /$check/) {
push(@sequenceHeadings, $cache->{$sequence.':title'});
push(@sequenceKeys, $sequence);
@@ -606,11 +864,21 @@ sub ShouldShowColumns {
$doNotShow{'count'} = $count;
- return (\@infoHeadings, \@infoKeys, \@sequenceHeadings,
+ return (\@infoHeadings, \@infoKeys, \@sequenceHeadings,
\@sequenceKeys, \%doNotShow);
}
+1;
-#---- END Student Assessment Worker Functions --------------------------------
+#######################################################
+#######################################################
+
+=pod
+
+=back
+
+=cut
+
+#######################################################
+#######################################################
-1;
__END__