File:  [LON-CAPA] / loncom / homework / response.pm
Revision 1.240: download - view: text, annotated - select for diffs
Sun Feb 22 01:34:48 2015 UTC (9 years, 2 months ago) by raeburn
Branches: MAIN
CVS tags: HEAD
- Bug 6476
  - Store rawrndseed for parts with all responsetypes.
  - Eliminate storage of rndseed, since rawrndseed is the item needed to
    reconstruct the randomization for a problem in Authoring Space.
  - If questiontype is randomizetry rawrndseed and rndseed are the same,
    so use rawrndseed from the submission history, where it exists.
  - Support use of randomizetry for script blocks outside a part block in
    problems with a single <part></part> tag.
  - Support use of randomizetry for script blocks inside part blocks.
Note: randomizetry does not apply to randomization in script blocks
outside part blocks for problems with multiple parts, because the
number of tries is not uniquely defined.

    1: # The LearningOnline Network with CAPA
    2: # various response type definitons response definition
    3: #
    4: # $Id: response.pm,v 1.240 2015/02/22 01:34:48 raeburn Exp $
    5: #
    6: # Copyright Michigan State University Board of Trustees
    7: #
    8: # This file is part of the LearningOnline Network with CAPA (LON-CAPA).
    9: #
   10: # LON-CAPA is free software; you can redistribute it and/or modify
   11: # it under the terms of the GNU General Public License as published by
   12: # the Free Software Foundation; either version 2 of the License, or
   13: # (at your option) any later version.
   14: #
   15: # LON-CAPA is distributed in the hope that it will be useful,
   16: # but WITHOUT ANY WARRANTY; without even the implied warranty of
   17: # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
   18: # GNU General Public License for more details.
   19: #
   20: # You should have received a copy of the GNU General Public License
   21: # along with LON-CAPA; if not, write to the Free Software
   22: # Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
   23: #
   24: # /home/httpd/html/adm/gpl.txt
   25: #
   26: # http://www.lon-capa.org/
   27: #
   28: 
   29: =pod
   30: 
   31: =head1 NAME
   32: 
   33: Apache::response.pm
   34: 
   35: =head1 SYNOPSIS
   36: 
   37: This is part of the LearningOnline Network with CAPA project
   38: described at http://www.lon-capa.org.
   39: 
   40: 
   41: =head1 NOTABLE SUBROUTINES
   42: 
   43: =over
   44: 
   45: =item 
   46: 
   47: =back
   48: 
   49: =cut
   50: 
   51: 
   52: package Apache::response;
   53: use strict;
   54: use Apache::lonlocal;
   55: use Apache::lonnet;
   56: use Apache::inputtags();
   57: use Apache::lonmaxima();
   58: use Apache::lonr();
   59: use Apache::lontexconvert();
   60: 
   61: BEGIN {
   62:     &Apache::lonxml::register('Apache::response',('responseparam','parameter','dataresponse','customresponse','mathresponse'));
   63: }
   64: 
   65: sub start_response {
   66:     my ($parstack,$safeeval)=@_;
   67:     my $id = &Apache::lonxml::get_id($parstack,$safeeval);
   68:     if ($#Apache::inputtags::import > -1) {
   69: 	&Apache::lonxml::debug("Turning :$id: into");
   70: 	$id = join('_',@Apache::inputtags::import).'_'.$id;
   71: 	&Apache::lonxml::debug("New  :$id:");
   72:     }
   73:     push (@Apache::inputtags::response,$id);
   74:     push (@Apache::inputtags::responselist,$id);
   75:     @Apache::inputtags::inputlist=();
   76:     if ($Apache::inputtags::part eq '' && 
   77: 	!$Apache::lonhomework::ignore_response_errors) {
   78: 	&Apache::lonxml::error(&HTML::Entities::encode(&mt("Found a <*response> outside of a <part> in a <part>ed problem"),'<>&"'));
   79:     }
   80:     if ($Apache::inputtags::response_with_no_part &&
   81: 	$Apache::inputtags::part ne '0') {
   82: 	&Apache::lonxml::error(&HTML::Entities::encode(&mt("<*response>s are both inside of <part> and outside of <part>, this is not a valid problem, errors in grading may occur."),'<>&"').'<br />');
   83:     }
   84:     if ($Apache::inputtags::part eq '0') {
   85: 	$Apache::inputtags::response_with_no_part=1;
   86:     }
   87:     return $id;
   88: }
   89: 
   90: sub end_response {
   91:     #pop @Apache::inputtags::response;
   92:     @Apache::inputtags::inputlist=();
   93:     return '';
   94: }
   95: 
   96: sub start_hintresponse {
   97:     my ($parstack,$safeeval)=@_;
   98:     my $id = &Apache::lonxml::get_id($parstack,$safeeval);
   99:     push (@Apache::inputtags::hint,$id);
  100:     push (@Apache::inputtags::hintlist,$id);
  101:     push (@Apache::inputtags::paramstack,[%Apache::inputtags::params]);
  102:     return $id;
  103: }
  104: 
  105: sub end_hintresponse {
  106:     pop @Apache::inputtags::hint;
  107:     if (defined($Apache::inputtags::paramstack[-1])) {
  108: 	%Apache::inputtags::params=
  109: 	    @{ pop(@Apache::inputtags::paramstack) };
  110:     }
  111:     return '';
  112: }
  113: 
  114: my @randomseeds;
  115: sub pushrandomnumber {
  116:     my $rand_alg=&Apache::lonnet::get_rand_alg();
  117:     if (!$rand_alg || $rand_alg eq '32bit' || $rand_alg eq '64bit' ||
  118: 	$rand_alg eq '64bit2') {
  119: 	# do nothing
  120:     } else {
  121: 	my @seed=&Math::Random::random_get_seed();
  122: 	push(@randomseeds,\@seed);
  123:     }
  124:     &Apache::response::setrandomnumber(@_);
  125: }
  126: sub poprandomnumber {
  127:     my $rand_alg=&Apache::lonnet::get_rand_alg();
  128:     if (!$rand_alg || $rand_alg eq '32bit' || $rand_alg eq '64bit' ||
  129: 	$rand_alg eq '64bit2') {
  130: 	return;
  131:     }
  132:     my $seed=pop(@randomseeds);
  133:     if ($seed) {
  134: 	&Math::Random::random_set_seed(@$seed);
  135:     } else {
  136: 	&Apache::lonxml::error("Unable to restore random algorithm.");
  137:     }
  138: }
  139: 
  140: sub setrandomnumber {
  141:     my ($ignore_id2,$target,$rndseed) = @_;
  142:     if (!defined($rndseed)) {
  143:         $rndseed=&Apache::structuretags::setup_rndseed(undef,$target);
  144:     } 
  145:     if (!defined($rndseed)) { $rndseed=&Apache::lonnet::rndseed(); }
  146:     &Apache::lonxml::debug("randseed $rndseed");
  147:     #  $rndseed=unpack("%32i",$rndseed);
  148:     my $rand_alg=&Apache::lonnet::get_rand_alg();
  149:     my ($rndmod,$rndmod2);
  150: 
  151:     my ($id1,$id2,$shift_amt);
  152:     if ($Apache::lonhomework::parsing_a_problem) {
  153: 	$id1=$Apache::inputtags::part;
  154: 	if (defined($Apache::inputtags::response[-1])) {
  155: 	    $id2=$Apache::inputtags::response[-1];
  156: 	}
  157: 	$shift_amt=scalar(@Apache::inputtags::responselist);
  158:     } elsif ($Apache::lonhomework::parsing_a_task) {
  159: 	$id1=&Apache::bridgetask::get_dim_id();
  160: 	if (!$ignore_id2 && ref($Apache::bridgetask::instance{$id1})) {
  161: 	    $id2=$Apache::bridgetask::instance{$id1}[-1];
  162: 	    $shift_amt=scalar(@{$Apache::bridgetask::instance{$id1}});
  163: 	} else {
  164: 	    $shift_amt=0;
  165: 	}
  166:     } 
  167:     &Apache::lonxml::debug("id1: $id1, id2: $id2, shift_amt: $shift_amt");
  168:     if (!$rand_alg || $rand_alg eq '32bit' || $rand_alg eq '64bit' ||
  169: 	$rand_alg eq '64bit2') {
  170: 	$rndmod=(&Apache::lonnet::numval($id1) << 10);
  171: 	if (defined($id2)) { $rndmod+=&Apache::lonnet::numval($id2); }
  172:     } elsif ($rand_alg eq '64bit3') {
  173: 	$rndmod=(&Apache::lonnet::numval2($id1) << 10);
  174: 	if (defined($id2)) { $rndmod+=&Apache::lonnet::numval2($id2); }
  175:     } elsif ($rand_alg eq '64bit4') {
  176: 	my $shift=(4*$shift_amt)%30;
  177: 	$rndmod=(&Apache::lonnet::numval3($id1) << (($shift+15)%30));
  178: 	if (defined($id2)) {
  179: 	    $rndmod+=(&Apache::lonnet::numval3($id2) << $shift );
  180: 	}
  181:     } else {
  182: 	($rndmod,$rndmod2)=&Apache::lonnet::digest("$id1,$id2");
  183:     }
  184:     if ($rndseed =~/([,:])/) {
  185: 	my $char=$1;
  186: 	use integer;
  187: 	my ($num1,$num2)=split(/\Q$char\E/,$rndseed);
  188: 	$num1+=$rndmod;
  189: 	$num2+= ((defined($rndmod2)) ? $rndmod2 : $rndmod);
  190: 	if($Apache::lonnet::_64bit) { $num1=(($num1<<32)>>32); $num2=(($num2<<32)>>32); }
  191: 	$rndseed=$num1.$char.$num2;
  192:     } else {
  193: 	$rndseed+=$rndmod;
  194: 	if($Apache::lonnet::_64bit) {
  195: 	    use integer;
  196: 	    $rndseed=(($rndseed<<32)>>32);
  197: 	}
  198:     }
  199:     &Apache::lonxml::debug("randseed $rndmod $rndseed");
  200:     &Apache::lonnet::setup_random_from_rndseed($rndseed);
  201:     return '';
  202: }
  203: 
  204: sub meta_parameter_write {
  205:     my ($name,$type,$default,$display)=@_;
  206:     my $partref=$Apache::inputtags::part;
  207:     my $result='<parameter part="'.$Apache::inputtags::part.'"';
  208:     if (defined($Apache::inputtags::response[-1])) {
  209: 	$result.=            ' id="'.$Apache::inputtags::response[-1].'"';
  210: 	$partref.='_'.$Apache::inputtags::response[-1];
  211:     }
  212:     $result.=            ' name="'.$name.'"'.
  213:                          ' type="'.$type.'"'.
  214: (defined($default)?' default="'.$default.'"':'').
  215: (defined($display)?' display="'.$display.' [Part: '.$partref.']"':'')
  216:              .'></parameter>'
  217:              ."\n";
  218:     return $result;
  219: }
  220: 
  221: sub meta_package_write {
  222:     my $name=shift;
  223:     my $result = '<parameter part="'.$Apache::inputtags::part.'"';
  224:     if(defined($Apache::inputtags::response[-1])) {
  225: 	$result.= ' id="'.$Apache::inputtags::response[-1].'"';
  226:     }
  227:     $result.=' package="'.$name.'"></parameter>'."\n";
  228:     return $result;
  229: }
  230: 
  231: sub meta_stores_write {
  232:     my ($name,$type,$display)=@_;
  233:     my $partref=$Apache::inputtags::part;
  234:     my $result = '<stores part="'.$Apache::inputtags::part.'"';
  235:     if (defined($Apache::inputtags::response[-1])) {
  236: 	$result.=           ' id="'.$Apache::inputtags::response[-1].'"';
  237: 	$partref.='_'.$Apache::inputtags::response[-1];
  238:     }	
  239:     $result.=          ' name="'.$name.'"'.
  240:                        ' type="'.$type.'"'.
  241: 	            ' display="'.$display.' [Part: '.$partref.']"'.
  242: 		      "></stores>\n";
  243: }
  244: 
  245: =pod
  246: 
  247: =item mandatory_part_meta()
  248: 
  249: Autogenerate metadata for mandatory
  250: input (from RAT or lonparmset) and
  251: output (to lonspreadsheet)
  252: of each part
  253: 
  254: Note: responseid-specific data 'submission' and 'awarddetail'
  255: not available to spreadsheet -> skip here
  256: 
  257: =cut
  258: 
  259: 
  260: sub mandatory_part_meta {
  261:     return &meta_package_write('part').
  262:            &meta_stores_write('solved','string','Problem Status').
  263:            &meta_stores_write('tries','int_zeropos','Number of Attempts').
  264:            &meta_stores_write('awarded','float','Partial Credit Factor');
  265: }
  266: 
  267: sub meta_part_order {
  268:     if (@Apache::inputtags::partlist) {
  269: 	my @parts=@Apache::inputtags::partlist;
  270: 	shift(@parts);
  271: 	return '<partorder>'.join(',',@parts).'</partorder>'."\n";
  272:     } else {
  273: 	return '<partorder>0</partorder>'."\n";
  274:     }
  275: }
  276: 
  277: sub meta_response_order {
  278:     if (@Apache::inputtags::responselist) {
  279: 	return '<responseorder>'.join(',',@Apache::inputtags::responselist).
  280: 	    '</responseorder>'."\n";
  281:     }
  282: }
  283: 
  284: sub check_for_previous {
  285:     my ($curresponse,$partid,$id,$last,$type) = @_;
  286:     my %previous;
  287:     $previous{'used'} = 0;
  288:     my $questiontype = $Apache::lonhomework::type;
  289:     my $curr_rndseed = $env{'form.'.$partid.'.rndseed'};
  290:     foreach my $key (sort(keys(%Apache::lonhomework::history))) {
  291: 	if ($key =~ /resource\.\Q$partid\E\.\Q$id\E\.submission$/) {
  292: 	    if ( $last && $key =~ /^(\d+):/ ) {
  293: 		next if ($1 >= $last);
  294: 	    }
  295: 	    &Apache::lonxml::debug("Trying $key");
  296: 	    my $pastresponse=$Apache::lonhomework::history{$key};
  297: 	    if ($pastresponse eq $curresponse) {
  298: 		my $history;
  299: 		if ( $key =~ /^(\d+):/ ) {
  300:                     $history=$1;
  301:                     next if ((($questiontype eq 'randomizetry') ||
  302:                              ($Apache::lonhomework::history{"$history:resource.$partid.type"} eq 'randomizetry')) &&
  303:                              ($curr_rndseed ne $Apache::lonhomework::history{"$history:resource.$partid.rndseed"}));
  304: 		    $previous{'award'} = $Apache::lonhomework::history{"$history:resource.$partid.$id.awarddetail"};
  305: 		    $previous{'last'}='0';
  306: 		    push(@{ $previous{'version'} },$history);
  307: 		} else {
  308:                     next if ((($questiontype eq 'randomizetry') ||
  309:                              ($Apache::lonhomework::history{"resource.$partid.type"} eq 'randomizetry')) &&
  310:                              ($curr_rndseed ne $Apache::lonhomework::history{"resource.$partid.rndseed"}));
  311: 		    $previous{'award'} = $Apache::lonhomework::history{"resource.$partid.$id.awarddetail"};
  312: 		    $previous{'last'}='1';
  313: 		}
  314:                 $previous{'used'} = 1;
  315: 		if (! $previous{'award'} ) { $previous{'award'} = 'UNKNOWN';	}
  316:                 if ($previous{'award'} eq 'INTERNAL_ERROR') { $previous{'used'}=0; }
  317: 		&Apache::lonxml::debug("got a match :$previous{'award'}:$previous{'used'}:");
  318:             } elsif ($type eq 'ci') {
  319:                 if (lc($pastresponse) eq lc($curresponse)) {
  320:                     if ($key =~ /^(\d+):/) {
  321:                         my $history = $1;
  322:                         next if (($questiontype eq 'randomizetry') &&
  323:                              ($curr_rndseed ne $Apache::lonhomework::history{"$history:resource.$partid.rndseed"}));
  324:                         push (@{$previous{'versionci'}},$history);
  325:                         $previous{'awardci'} = $Apache::lonhomework::history{"$history:resource.$partid.$id.awarddetail"};
  326:                         $previous{'usedci'} = 1;
  327:                     }
  328:                 }
  329:             }
  330: 	}
  331:     }
  332:     &Apache::lonhomework::showhash(%previous);
  333:     return %previous;
  334: }
  335: 
  336: sub handle_previous {
  337:     my ($previous,$ad)=@_;
  338:     if ($$previous{'used'} && ($$previous{'award'} eq $ad) ) {
  339: 	if ($$previous{'last'}) {
  340: 	    push(@Apache::inputtags::previous,'PREVIOUSLY_LAST');
  341: 	    push(@Apache::inputtags::previous_version,$$previous{'version'});
  342: 	} elsif (($Apache::lonhomework::type ne 'survey') &&
  343:                  ($Apache::lonhomework::type ne 'surveycred') &&
  344:                  ($Apache::lonhomework::type ne 'anonsurvey') &&
  345:                  ($Apache::lonhomework::type ne 'anonsurveycred')) {
  346: 	    push(@Apache::inputtags::previous,'PREVIOUSLY_USED');
  347: 	    push(@Apache::inputtags::previous_version,$$previous{'version'});
  348: 	}
  349:     }
  350: }
  351: 
  352: sub view_or_modify {
  353:     my ($symb,$courseid,$domain,$name) = &Apache::lonnet::whichuser();
  354:     my $myself=0;
  355:     if ( ($name eq $env{'user.name'}) && ($domain eq $env{'user.domain'}) ) {
  356: 	$myself=1;
  357:     }
  358:     my $vgr=&Apache::lonnet::allowed('vgr',$courseid);
  359:     my $mgr=&Apache::lonnet::allowed('vgr',$courseid);
  360:     if ($mgr) { return "M"; }
  361:     if ($vgr) { return "V"; }
  362:     if ($myself) { return "V"; }
  363:     return '';
  364: }
  365: 
  366: sub start_dataresponse {
  367:     my ($target,$token,$tagstack,$parstack,$parser,$safeeval)=@_;
  368:     my $id = &Apache::response::start_response($parstack,$safeeval);
  369:     my $result;
  370:     if ($target eq 'web') {
  371: 	$result = $token->[2]->{'display'}.':';
  372:     } elsif ($target eq 'meta') {
  373: 	$result = &Apache::response::meta_stores_write($token->[2]->{'name'},
  374: 						       $token->[2]->{'type'},
  375: 						       $token->[2]->{'display'});
  376: 	$result .= &Apache::response::meta_package_write('dataresponse');
  377:     }
  378:     return $result;
  379: }
  380: 
  381: sub end_dataresponse {
  382:     my ($target,$token,$tagstack,$parstack,$parser,$safeeval)=@_;
  383:     my $result;
  384:     if ( $target eq 'web' ) {
  385:     } elsif ($target eq 'grade' ) {
  386: 	if ( defined $env{'form.submitted'}) {
  387: 	    my ($symb,$courseid,$domain,$name)=&Apache::lonnet::whichuser();
  388: 	    my $allowed=&Apache::lonnet::allowed('mgr',$courseid);
  389: 	    if ($allowed) {
  390: 		&Apache::response::setup_params('dataresponse',$safeeval);
  391: 		my $partid = $Apache::inputtags::part;
  392: 		my $id = $Apache::inputtags::response['-1'];
  393: 		my $response = $env{'form.HWVAL_'.$id};
  394: 		my $name = &Apache::lonxml::get_param('name',$parstack,$safeeval);
  395: 		if ( $response =~ /[^\s]/) {
  396: 		    $Apache::lonhomework::results{"resource.$partid.$id.$name"}=$response;
  397: 		    $Apache::lonhomework::results{"resource.$partid.$id.submission"}=$response;
  398: 		    $Apache::lonhomework::results{"resource.$partid.$id.awarddetail"}='SUBMITTED';
  399: 		}
  400: 	    } else {
  401:                 $result=&mt('Not Permitted to change values');
  402: 	    }
  403: 	}
  404:     }
  405:     &Apache::response::end_response;
  406:     return $result;
  407: }
  408: 
  409: sub start_customresponse {
  410:     my ($target,$token,$tagstack,$parstack,$parser,$safeeval)=@_;
  411:     my $id = &Apache::response::start_response($parstack,$safeeval);
  412:     push(@Apache::lonxml::namespace,'customresponse');
  413:     my $result;
  414:     @Apache::response::custom_answer=();
  415:     @Apache::response::custom_answer_type=();
  416:     &Apache::lonxml::register('Apache::response',('answer'));
  417:     if ($target eq 'web') {
  418:   	if (  &Apache::response::show_answer() ) {
  419: 	    my $answer = &Apache::lonxml::get_param('answerdisplay',$parstack,
  420: 						   $safeeval);
  421: 	    $Apache::inputtags::answertxt{$id}=[$answer];
  422: 	}
  423:     } elsif ($target eq 'edit') {
  424: 	$result.=&Apache::edit::tag_start($target,$token);
  425: 	$result.=&Apache::edit::text_arg('String to display for answer:',
  426: 					 'answerdisplay',$token,'50');
  427: 	$result.=&Apache::edit::end_row().&Apache::edit::start_spanning_row();
  428:     } elsif ($target eq 'modified') {
  429: 	my $constructtag;
  430: 	$constructtag=&Apache::edit::get_new_args($token,$parstack,
  431: 						  $safeeval,'answerdisplay');
  432: 	if ($constructtag) {
  433: 	    $result = &Apache::edit::rebuild_tag($token);
  434: 	}
  435:     } elsif ($target eq 'answer' || $target eq 'grade') {
  436: 	&Apache::response::reset_params();
  437:     } elsif ($target eq 'meta') {
  438: 	$result .= &Apache::response::meta_package_write('customresponse');
  439:     }
  440:     return $result;
  441: }
  442: 
  443: sub end_customresponse {
  444:     my ($target,$token,$tagstack,$parstack,$parser,$safeeval)=@_;
  445:     my $result;
  446:     my $part=$Apache::inputtags::part;
  447:     my $id=$Apache::inputtags::response[-1];
  448:     if ( $target eq 'grade' && &Apache::response::submitted() ) {
  449: 	my $response = &Apache::response::getresponse();
  450: 	if ($Apache::lonhomework::type eq 'exam' ||
  451: 	    &Apache::response::submitted('scantron')) {
  452: 	    &Apache::response::scored_response($part,$id);
  453: 	} elsif ( $response =~ /[^\s]/ && 
  454: 		  $Apache::response::custom_answer_type[-1] eq 'loncapa/perl') {
  455: 	    if (!$Apache::lonxml::default_homework_loaded) {
  456: 		&Apache::lonxml::default_homework_load($safeeval);
  457: 	    }
  458: 	    my %previous = &Apache::response::check_for_previous($response,
  459: 								 $part,$id);
  460: 	    $Apache::lonhomework::results{"resource.$part.$id.submission"}=
  461: 		$response;
  462: 	    my $error;
  463: 	    ${$safeeval->varglob('LONCAPA::customresponse_submission')}=
  464: 		$response;
  465: 	    
  466: 	    my ($award,$score) = &Apache::run::run('{ my $submission=$LONCAPA::customresponse_submission;'.$Apache::response::custom_answer[-1].'}',$safeeval);
  467: 	    if (!&Apache::inputtags::valid_award($award)) {
  468: 		$error = $award;
  469: 		$award = 'ERROR';
  470: 	    }
  471:             if (($award eq 'INCORRECT' || $award eq 'APPROX_ANS' ||
  472:                  $award eq 'EXACT_ANS')) {
  473:                 if ($Apache::lonhomework::type eq 'survey') {
  474:                     $award='SUBMITTED';
  475:                 } elsif ($Apache::lonhomework::type eq 'surveycred') {
  476:                     $award='SUBMITTED_CREDIT';
  477:                 } elsif ($Apache::lonhomework::type eq 'anonsurvey') {
  478:                     $award='ANONYMOUS';
  479:                 } elsif ($Apache::lonhomework::type eq 'anonsurveycred') {
  480:                     $award='ANONYMOUS_CREDIT';
  481:                 }
  482:             }
  483: 	    &Apache::response::handle_previous(\%previous,$award);
  484: 	    $Apache::lonhomework::results{"resource.$part.$id.awarddetail"}=
  485: 		$award;
  486:             if ($award eq 'ASSIGNED_SCORE') {
  487:                 $Apache::lonhomework::results{"resource.$part.$id.awarded"}=1.0*$score;
  488:             }
  489: 	    if ($error) {
  490: 		$Apache::lonhomework::results{"resource.$part.$id.awardmsg"}=
  491: 		    $error;
  492: 	    }
  493: 	}
  494:     } elsif ( $target eq 'answer') {
  495: 	$result  = &Apache::response::answer_header('customresponse');
  496: 	my $answer = &Apache::lonxml::get_param('answerdisplay',$parstack,
  497: 						$safeeval);
  498: 	if ($env{'form.answer_output_mode'} ne 'tex') {
  499: 	    $answer = '<b>'.$answer.'</b>';
  500: 	}
  501: 	$result .= &Apache::response::answer_part('customresponse',$answer);
  502: 	$result .= &Apache::response::answer_footer('customresponse');
  503:     }
  504:     if ($target eq 'web') {
  505: 	&setup_prior_tries_hash(\&format_prior_response_custom);
  506:     }
  507:     if ($target eq 'grade' || $target eq 'web' || $target eq 'answer' || 
  508: 	$target eq 'tex' || $target eq 'analyze') {
  509:         my $repetition = &repetition();
  510: 	&Apache::lonxml::increment_counter($repetition,"$part.$id");
  511: 	if ($target eq 'analyze') {
  512:             $Apache::lonhomework::analyze{"$part.$id.type"} = 'customresponse';
  513: 	    &Apache::lonhomework::set_bubble_lines();
  514: 	}
  515:     }
  516:     pop(@Apache::lonxml::namespace);
  517:     pop(@Apache::response::custom_answer);
  518:     pop(@Apache::response::custom_answer_type);
  519:     &Apache::lonxml::deregister('Apache::response',('answer'));
  520:     &Apache::response::end_response();
  521:     return $result;
  522: }
  523: 
  524: sub format_prior_response_custom {
  525:     my ($mode,$answer) =@_;
  526:     if (ref($answer) eq 'ARRAY') {
  527:         $answer = '('.join(', ', @{ $answer }).')';
  528:     }
  529:     return '<span class="LC_prior_custom">'.
  530: 	    &HTML::Entities::encode($answer,'"<>&').'</span>';
  531: }
  532: 
  533: sub start_mathresponse {
  534:     my ($target,$token,$tagstack,$parstack,$parser,$safeeval)=@_;
  535:     my $id = &Apache::response::start_response($parstack,$safeeval);
  536:     push(@Apache::lonxml::namespace,'mathresponse');
  537:     my $result;
  538:     @Apache::response::custom_answer=();
  539:     @Apache::response::custom_answer_type=();
  540:     &Apache::lonxml::register('Apache::response',('answer'));
  541:     if ($target eq 'web') {
  542:   	if (  &Apache::response::show_answer() ) {
  543: 	    my $answer = &Apache::lonxml::get_param('answerdisplay',$parstack,
  544: 						   $safeeval);
  545: 	    $Apache::inputtags::answertxt{$id}=[$answer];
  546: 	}
  547: 
  548:     } elsif ($target eq 'edit') {
  549: 	$result.=&Apache::edit::tag_start($target,$token);
  550: 	$result.=&Apache::edit::text_arg('String to display for answer:',
  551: 					 'answerdisplay',$token,'50');
  552: 	$result.=&Apache::edit::select_arg('Algebra System:',
  553: 					   'cas',
  554: 					   ['maxima','R'],
  555: 					   $token);
  556: 	$result.=&Apache::edit::text_arg('Argument Array:',
  557: 					 'args',$token).
  558:                  &Apache::loncommon::help_open_topic('Maxima_Argument_Array');
  559:         $result.=&Apache::edit::text_arg('Libraries:',
  560:                                          'libraries',$token).
  561:                  &Apache::loncommon::help_open_topic('Maxima_Libraries');
  562: 	$result.=&Apache::edit::end_row().&Apache::edit::start_spanning_row();
  563:     } elsif ($target eq 'modified') {
  564: 	my $constructtag;
  565: 	$constructtag=&Apache::edit::get_new_args($token,$parstack,
  566: 						  $safeeval,'answerdisplay','cas','args','libraries');
  567: 	if ($constructtag) {
  568: 	    $result = &Apache::edit::rebuild_tag($token);
  569: 	}
  570:     } elsif ($target eq 'answer' || $target eq 'grade') {
  571: 	&Apache::response::reset_params();
  572:     } elsif ($target eq 'meta') {
  573: 	$result .= &Apache::response::meta_package_write('mathresponse');
  574:     }
  575:     return $result;
  576: }
  577: 
  578: sub edit_mathresponse_button {
  579:     my ($partid,$id)=@_;
  580:     my $field = 'HWVAL_'.$partid.'_'.$id;
  581:     my $btype = $env{'browser.type'};
  582:     my $bversion = $env{'browser.version'};
  583:     if (($btype eq 'explorer' && $bversion < 9) || ($btype eq 'safari' && $bversion < 3) ||
  584:         ($btype eq 'mozilla' && $bversion < 3)) {
  585:       # DragMath applet
  586:       my $button=&mt('Edit Answer');
  587: #     my $helplink=&Apache::loncommon::help_open_topic('Formula_Editor');
  588:       my $iconpath=$Apache::lonnet::perlvar{'lonIconsURL'};
  589:       return(<<ENDFORMULABUTTON);
  590: <script type="text/javascript" language="JavaScript">
  591: function LC_mathedit_${field} (LCtextline) {
  592:     thenumber = LCtextline;
  593:     var thedata = '';
  594:     if (document.getElementById(LCtextline)) {
  595:         thedata = document.getElementById(LCtextline).value;
  596:     }
  597:     newwin = window.open("/adm/dragmath/MaximaPopup.html","","width=565,height=400,resizable");
  598: }
  599: </script>
  600: <a href="javascript:LC_mathedit_${field}('${field}');void(0);"><img class="stift" src="$iconpath/stift.gif" alt="$button" title="$button" /></a>
  601: ENDFORMULABUTTON
  602:       
  603:     } else {
  604:         # LON-CAPA math equation editor
  605:         my $mathjaxjs;
  606:         unless (lc(&Apache::lontexconvert::tex_engine()) eq 'mathjax') {
  607:             $mathjaxjs = <<"MATHJAX_SCRIPT";
  608: var mathjaxscript = document.createElement("script");
  609:     mathjaxscript.type = "text/javascript";
  610:     mathjaxscript.src = "/adm/MathJax/MathJax.js?config=TeX-AMS-MML_HTMLorMML";
  611:     document.body.appendChild(mathjaxscript);
  612: MATHJAX_SCRIPT
  613:         }
  614:         return(<<EQ_EDITOR_SCRIPT);
  615: <script type="text/javascript">
  616:   var LCmathField = document.getElementById('${field}');
  617:   LCmathField.className += ' math'; // note the space
  618:   LCmathField.setAttribute('data-implicit_operators', 'true');
  619:   var LCMATH_started;
  620:   if (typeof LCMATH_started === 'undefined') {
  621:     $mathjaxjs
  622:     LCMATH_started = true;
  623:     var script = document.createElement("script");
  624:     script.type = "text/javascript";
  625:     script.src = "/adm/LC_math_editor/LC_math_editor.min.js";
  626:     document.body.appendChild(script);
  627:     window.addEventListener('load', function(e) {
  628:         LCMATH.initEditors();
  629:     }, false);
  630:   }
  631: </script>
  632: EQ_EDITOR_SCRIPT
  633:     }
  634: }
  635: 
  636: sub end_mathresponse {
  637:     my ($target,$token,$tagstack,$parstack,$parser,$safeeval)=@_;
  638:     my $result;
  639:     my $part=$Apache::inputtags::part;
  640:     my $id=$Apache::inputtags::response[-1];
  641:     if ( $target eq 'grade' && &Apache::response::submitted() ) {
  642: 	my $response = &Apache::response::getresponse();
  643: 	if ( $response =~ /[^\s]/ ) {
  644: 	    if (!$Apache::lonxml::default_homework_loaded) {
  645: 		&Apache::lonxml::default_homework_load($safeeval);
  646: 	    }
  647: 	    my %previous = &Apache::response::check_for_previous($response,
  648: 								 $part,$id);
  649: 	    $Apache::lonhomework::results{"resource.$part.$id.submission"}=
  650: 		$response;
  651: 	    my $error;
  652: 	    my $award;
  653: 	    my $cas = &Apache::lonxml::get_param('cas',$parstack,$safeeval);
  654:             if ($cas eq 'maxima') {
  655:                 my $args = [&Apache::lonxml::get_param_var('args',$parstack,$safeeval)];
  656:                 $award=&Apache::lonmaxima::maxima_run($Apache::response::custom_answer[-1],$response,$args,
  657:                                                       &Apache::lonxml::get_param('libraries',$parstack,$safeeval));
  658:             }
  659:             if ($cas eq 'R') {
  660:                 my $args = [&Apache::lonxml::get_param_var('args',$parstack,$safeeval)];
  661:                 $award=&Apache::lonr::r_run($Apache::response::custom_answer[-1],$response,$args,
  662:                                             &Apache::lonxml::get_param('libraries',$parstack,$safeeval));
  663:             }
  664: 
  665: 	    if (!&Apache::inputtags::valid_award($award)) {
  666: 		$error = $award;
  667: 		$award = 'ERROR';
  668: 	    }
  669:             if (($award eq 'INCORRECT' || $award eq 'APPROX_ANS' ||
  670:                  $award eq 'EXACT_ANS')) {
  671:                 if ($Apache::lonhomework::type eq 'survey') {
  672:                     $award='SUBMITTED';
  673:                 } elsif ($Apache::lonhomework::type eq 'surveycred') {
  674:                     $award='SUBMITTED_CREDIT';
  675:                 } elsif ($Apache::lonhomework::type eq 'anonsurvey') {
  676:                     $award='ANONYMOUS';
  677:                 } elsif ($Apache::lonhomework::type eq 'anonsurveycred') {
  678:                     $award='ANONYMOUS_CREDIT';
  679:                 }
  680:             }
  681: 	    &Apache::response::handle_previous(\%previous,$award);
  682: 	    $Apache::lonhomework::results{"resource.$part.$id.awarddetail"}=
  683: 		$award;
  684: 	    if ($error) {
  685: 		$Apache::lonhomework::results{"resource.$part.$id.awardmsg"}=
  686: 		    $error;
  687: 	    }
  688: 	}
  689:     }
  690:     if ($target eq 'web') {
  691: 	&setup_prior_tries_hash(\&format_prior_response_math);
  692:         my $partid = $Apache::inputtags::part;
  693:         my $id = $Apache::inputtags::response[-1];
  694:         if (($Apache::inputtags::status['-1'] eq 'CAN_ANSWER')
  695:            && (&Apache::lonnet::EXT('resource.'.$partid.'_'.$id.'.turnoffeditor') ne 'yes')) {
  696:             $result.=&edit_mathresponse_button($partid,$id);
  697:         }
  698:     }
  699: 
  700:     pop(@Apache::lonxml::namespace);
  701:     pop(@Apache::response::custom_answer);
  702:     pop(@Apache::response::custom_answer_type);
  703:     &Apache::lonxml::deregister('Apache::response',('answer'));
  704:     &Apache::response::end_response();
  705:     return $result;
  706: }
  707: 
  708: sub format_prior_response_math {
  709:     my ($mode,$answer) =@_;
  710:     return '<span class="LC_prior_math">'.
  711: 	    &HTML::Entities::encode($answer,'"<>&').'</span>';
  712: }
  713: 
  714: sub implicit_multiplication {
  715:     my ($expression)=@_;
  716: # Escape scientific notation, so 3e8 does not become 3*e*8
  717: # 3e8 -> 3&8; 3e-8 -> 3&-8; 3E+8 -> e&+8
  718:     $expression=~s/(\d+)e([\+\-]*\d+)/$1\&\($2\)/gsi;
  719: # 3x10^8 -> 3&8; 3*10^-8 -> 3&-8
  720:     $expression=~s/(\d+)(?:x|\*)10(?:\^|\*\*)([\+\-]*\d+)/$1\&\($2\)/gsi;
  721: # Fill in multiplication signs
  722: # a b -> a*b;3 b -> 3*b;3 4 -> 3*4
  723:     $expression=~s/([A-Za-z0-9])\s+(?=[A-Za-z0-9])/$1\*/gs;
  724: # )( -> )*(; ) ( -> )*(
  725:     $expression=~s/\)\s*\(/\)\*\(/gs;
  726: # 3a -> 3*a; 3( -> 3*(; 3 ( -> 3*(; 3A -> 3*A
  727:     $expression=~s/(\d)\s*([a-zA-Z\(])/$1\*$2/gs;
  728: # a ( -> a*(
  729:     $expression=~s/([A-Za-z0-9])\s+\(/$1\*\(/gs;
  730: # )a -> )*a; )3 -> )*3; ) 3 -> )*3
  731:     $expression=~s/\)\s*([A-Za-z0-9])/\)\*$1/gs;
  732: # 3&8 -> 3e8; 3&-4 -> 3e-4
  733:     $expression=~s/(\d+)\&\(([\+\-]*\d+)\)/$1e$2/gs;
  734:     return $expression;
  735: }
  736: 
  737: sub start_answer {
  738:     my ($target,$token,$tagstack,$parstack,$parser,$safeeval)=@_;
  739:     my $result;
  740:     push(@Apache::response::custom_answer,
  741: 	&Apache::lonxml::get_all_text_unbalanced("/answer",$parser));
  742:     push(@Apache::response::custom_answer_type,
  743: 	lc(&Apache::lonxml::get_param('type',$parstack,$safeeval)));
  744:     $Apache::response::custom_answer_type[-1] =~ s/\s+//g;
  745:     if ($target eq "edit" ) {
  746: 	$result=&Apache::edit::tag_start($target,$token,'Answer algorithm');
  747: 	$result.=&Apache::edit::editfield($token->[1],
  748: 					  $Apache::response::custom_answer[-1],
  749: 					  '',80,4);
  750:     } elsif ( $target eq "modified" ) {
  751: 	$result=$token->[4].&Apache::edit::modifiedfield('/answer',$parser);
  752:     }
  753:     return $result;
  754: }
  755: 
  756: sub end_answer {
  757:     my ($target,$token,$tagstack,$parstack,$parser,$safeeval)=@_;
  758:     if ($target eq 'edit' ) {
  759: 	return &Apache::edit::end_table();
  760:     }
  761: }
  762: 
  763: sub decide_package {
  764:     my ($tagstack)=@_;
  765:     my $package;
  766:     if ($$tagstack[-1] eq 'parameter') {
  767: 	$package='part';
  768:     } else {
  769: 	my $i=-1;
  770: 	while (defined($$tagstack[$i])) {
  771: 	    if ($$tagstack[$i] =~ /(response|hint)$/) {
  772: 		$package=$$tagstack[$i];
  773: 		last;
  774: 	    }
  775: 	    $i--;
  776: 	}
  777:     }
  778:     return $package;
  779: }
  780: 
  781: sub start_responseparam {
  782:     my ($target,$token,$tagstack,$parstack,$parser,$safeeval)=@_;
  783:     my $result='';
  784:     if ($target eq 'meta') {
  785: 	$result = &meta_parameter_write($token->[2]->{'name'},
  786: 					$token->[2]->{'type'},
  787: 					$token->[2]->{'default'},
  788: 					$token->[2]->{'description'});
  789:     } elsif ($target eq 'edit') {
  790: 	$result.=&Apache::edit::tag_start($target,$token);
  791: 	my $optionlist;
  792: 	my $package=&decide_package($tagstack);
  793: 	foreach my $key (sort(keys(%Apache::lonnet::packagetab))) {
  794: 	    if ($key =~ /^\Q$package\E&(.*)&display$/) {
  795: 		$optionlist.='<option value="'.$1.'">'.
  796: 		    $Apache::lonnet::packagetab{$key}.'</option>';
  797: 	    }
  798: 	}
  799: 	if (defined($optionlist)) {
  800: 	    $result.=&mt('Use template:').' <select name="'.
  801: 		&Apache::edit::html_element_name('parameter_package').'">'.
  802: 		    '<option value=""></option>'.$optionlist.'</select><br />';
  803: 	}
  804: 	$result.=&Apache::edit::text_arg('Name:','name',$token).
  805: 	    &Apache::edit::text_arg('Type:','type',$token).
  806: 		&Apache::edit::text_arg('Description:','description',$token).
  807: 		    &Apache::edit::text_arg('Default:','default',$token).
  808: 			"</td></tr>";
  809: 	$result.=&Apache::edit::end_table;
  810:     } elsif ($target eq 'modified') {
  811: 	my $constructtag=&Apache::edit::get_new_args($token,$parstack,
  812: 						     $safeeval,'name','type',
  813: 						     'description','default');
  814: 	my $element=&Apache::edit::html_element_name('parameter_package');
  815: 	if (defined($env{"form.$element"}) && $env{"form.$element"} ne '') {
  816: 	    my $name=$env{"form.$element"};
  817: 	    my $tag=&decide_package($tagstack);
  818: 	    $token->[2]->{'name'}=$name;
  819: 	    $token->[2]->{'type'}=
  820: 		$Apache::lonnet::packagetab{"$tag&$name&type"};
  821: 	    $token->[2]->{'description'}=
  822: 		$Apache::lonnet::packagetab{"$tag&$name&display"};
  823: 	    $token->[2]->{'default'}=
  824: 		$Apache::lonnet::packagetab{"$tag&$name&default"};
  825:             $token->[3] = ['name','type','description','default'];
  826: 	    $constructtag=1;
  827: 	}
  828: 	if ($constructtag) {
  829: 	    $result = &Apache::edit::rebuild_tag($token);
  830: 	}
  831:     } elsif ($target eq 'grade' || $target eq 'answer' || $target eq 'web' ||
  832: 	     $target eq 'tex' || $target eq 'analyze' ) {
  833: 	if ($env{'request.state'} eq 'construct') {
  834: 	    my $name   =&Apache::lonxml::get_param('name',$parstack,$safeeval);
  835: 	    my $default=&Apache::lonxml::get_param('default',$parstack,
  836: 						     $safeeval);
  837: 	    if ($name) {$Apache::inputtags::params{$name}=$default;}
  838: 	}
  839:     }
  840:     return $result;
  841: }
  842: 
  843: sub end_responseparam {
  844:     my ($target,$token,$tagstack,$parstack,$parser,$safeeval)=@_;
  845:     if ($target eq 'edit') { return ('','no'); }
  846:     return '';
  847: }
  848: 
  849: sub start_parameter {
  850:     return &start_responseparam(@_);
  851: }
  852: 
  853: sub end_parameter {
  854:     return &end_responseparam(@_);
  855: }
  856: 
  857: sub reset_params {
  858:     %Apache::inputtags::params=();
  859: }
  860: 
  861: sub setup_params {
  862:     my ($tag,$safeeval) = @_;
  863: 
  864:     if ($env{'request.state'} eq 'construct') { return; }
  865:     my %paramlist=();
  866:     foreach my $key (keys(%Apache::lonnet::packagetab)) {
  867: 	if ($key =~ /^\Q$tag\E/) {
  868: 	    my ($package,$name) = split(/&/,$key);
  869: 	    $paramlist{$name}=1;
  870: 	}
  871:     }
  872:     foreach my $key (keys(%paramlist)) {
  873: 	my $entry= 'resource.'.$Apache::inputtags::part;
  874: 	if (defined($Apache::inputtags::response[-1])) {
  875: 	    $entry.='_'.$Apache::inputtags::response[-1];
  876: 	}
  877: 	$entry.='.'.$key;
  878: 	&Apache::lonxml::debug("looking for $entry");
  879: 	my $value = &Apache::lonnet::EXT("$entry");
  880: 	&Apache::lonxml::debug("$key has value :$value:");
  881: 	if ($value eq 'con_lost' || $value =~ /^error:/) {
  882: 	    &Apache::lonxml::debug("using nothing");
  883: 	    $Apache::inputtags::params{$key}='';
  884: 	} else {
  885: 	    my $string="{return qq\0".$value."\0}";
  886: 	    my $newvalue=&Apache::run::run($string,$safeeval,1);
  887: 	    if (defined($newvalue)) { $value=$newvalue; }
  888: 	    $Apache::inputtags::params{$key}=$value;
  889: 	}
  890:     }
  891: }
  892: 
  893: {
  894:     my @answer_bits;
  895:     my $need_row_start;
  896: 
  897: sub answer_header {
  898:     my ($type,$increment,$rows) = @_;
  899:     my $result;
  900:     if ($env{'form.answer_output_mode'} eq 'tex') {
  901: 	undef(@answer_bits);
  902: 	my $bit;
  903: 	if ($Apache::lonhomework::type eq 'exam') {
  904: 	    $bit = ($Apache::lonxml::counter+$increment).') ';
  905: 	} else {
  906:             $bit .= ' '.&mt('Answer for Part: [_1]',
  907:                                 '\verb|'.$Apache::inputtags::part.'|').' ';
  908: 	}
  909: 	push(@answer_bits,$bit);
  910:     } else {
  911: 	my $td = '<td '.(defined($rows)?'rowspan="'.$rows.'"':'').'>';
  912: 	$result  = '<table border="1"><tr>';
  913: 	if ($Apache::lonhomework::type eq 'exam') {
  914: 	    $result .= $td.($Apache::lonxml::counter+$increment). ')</td>';
  915: 	} else {
  916: 	    $result .= $td.&mt('Answer for Part: [_1]',
  917: 			       $Apache::inputtags::part).'</td>';
  918: 	}
  919: 	$result .= "\n";
  920: 	$need_row_start = 0;
  921:     }
  922:     return $result;
  923: }
  924: 
  925: sub next_answer {
  926:     my ($type) = @_;
  927:     my $result;
  928:     if ($env{'form.answer_output_mode'} eq 'tex') {
  929: 	# FIXME ... need to do something with tex mode
  930:     } else {
  931: 	$result .= "</tr>";
  932: 	$need_row_start = 1;
  933:     }
  934:     return $result;
  935: }
  936: 
  937: sub answer_part {
  938:     my ($type,$answer,$args) = @_;
  939:     my $result;
  940:     if ($env{'form.answer_output_mode'} eq 'tex') {
  941: 	if (!$args->{'no_verbatim'}) {
  942: 	    my $to_use='|';
  943: 	    foreach my $value (32..126) {
  944: 		my $char=pack('c',$value);
  945: 		if ($answer !~ /\Q$char\E/) {
  946: 		    $to_use=$char;
  947: 		    last;
  948: 		}
  949: 	    }
  950:             my $fullanswer=$answer;
  951:             $answer='';
  952:             foreach my $element (split(/[\;]/,$fullanswer)) {
  953: 	       if ($element ne '') {
  954: 	 	  $answer.= '\verb'.$to_use.$element.$to_use.' \newline';
  955: 	       }
  956:             }
  957: 	}
  958: 	if ($answer ne '') {
  959: 	    push(@answer_bits,$answer);
  960: 	}
  961:     } else {
  962: 	if ($need_row_start) {
  963: 	    $result .= '<tr>';
  964: 	    $need_row_start = 0;
  965: 	}
  966: 	$result .= '<td>'.$answer.'</td>';
  967:     }
  968:     return $result;
  969: }
  970: 
  971: sub answer_footer {
  972:     my ($type) = @_;
  973:     my $result;
  974:     if ($env{'form.answer_output_mode'} eq 'tex') {
  975: 	$result  = ' \vskip 0 mm \noindent \begin{tabular}{|p{1.5cm}|p{6.8cm}|}\hline ';
  976: 	$result .= $answer_bits[0].'&\vspace*{-4mm}\begin{itemize}';
  977:         for (my $i=1;$i<=$#answer_bits;$i++) {
  978:             $result.='\item '.$answer_bits[$i].'\vspace*{-7mm}';
  979:         }
  980: 	$result .= ' \end{itemize} \\\\ \hline \end{tabular} \vskip 0 mm ';
  981:     } else {
  982: 	if (!$need_row_start) {
  983: 	    $result .= '</tr>';
  984: 	}
  985: 	$result .= '</table>';
  986:     }
  987:     return $result;
  988: }
  989: 
  990: }
  991: 
  992: sub showallfoils {
  993:     if (defined($env{'form.showallfoils'})) {
  994: 	my ($symb)=&Apache::lonnet::whichuser();
  995: 	if (($env{'request.state'} eq 'construct') || 
  996: 	    ($env{'user.adv'} && $symb eq '')      ||
  997:             ($Apache::lonhomework::viewgrades) ) {
  998: 	    return 1;
  999: 	}
 1000:     }
 1001:     if ($Apache::lonhomework::type eq 'survey') { return 1; }
 1002:     if ($Apache::lonhomework::type eq 'surveycred') { return 1; }
 1003:     if ($Apache::lonhomework::type eq 'anonsurvey') { return 1; }
 1004:     if ($Apache::lonhomework::type eq 'anonsurveycred') { return 1; }
 1005: 
 1006:     return 0;
 1007: }
 1008: 
 1009: =pod
 1010: 
 1011: =item &getresponse();
 1012: 
 1013: Retreives the current submitted response, helps out in the case of
 1014: scantron mode.
 1015: 
 1016: Returns either the exact text of the submission, or a bubbled response
 1017: converted to something usable.
 1018: 
 1019: Optional Arguments:
 1020:   $offset - (defaults to 1) if a problem has more than one bubble
 1021:             response, pass in the number of the bubble wanted, (the
 1022:             first bubble associated with a problem has an offset of 1,
 1023:             the second bubble is 2
 1024: 
 1025:   $resulttype - undef    -> a number between 0 and 25
 1026:                 'A is 1' -> a number between 1 and 26
 1027:                 'letter' -> a letter between 'A' and 'Z'
 1028:   $lines  - undef problem only needs a single line of bubbles.
 1029:             nonzero  Problem wants the first nonempty response in 
 1030:                       $lines lines of bubbles.
 1031:   $bubbles_per_line - Must be provided if lines is defined.. number of
 1032:                       bubbles on a line.
 1033: 
 1034: =cut
 1035: 
 1036: sub getresponse {
 1037:     my ($offset,$resulttype, $lines, $bubbles_per_line)=@_;
 1038:     my $formparm='form.HWVAL_'.$Apache::inputtags::response['-1'];
 1039:     my $response;
 1040:     if (!defined($offset)) {
 1041: 	$offset=1;
 1042:     } else {
 1043: 	$formparm.=":$offset";
 1044:     }
 1045:     if (!defined($lines)) {
 1046: 	$lines = 1;
 1047:     }
 1048:     my %let_to_num=('A'=>0,'B'=>1,'C'=>2,'D'=>3,'E'=>4,'F'=>5,'G'=>6,'H'=>7,
 1049: 		    'I'=>8,'J'=>9,'K'=>10,'L'=>11,'M'=>12,'N'=>13,'O'=>14,
 1050: 		    'P'=>15,'Q'=>16,'R'=>17,'S'=>18,'T'=>19,'U'=>20,'V'=>21,
 1051: 		    'W'=>22,'X'=>23,'Y'=>24,'Z'=>25);
 1052:     if ($env{'form.submitted'} eq 'scantron') {
 1053: 	my $part  = $Apache::inputtags::part;
 1054: 	my $id    = $Apache::inputtags::response[-1];
 1055: 	
 1056: 	my $line;
 1057: 	my $startline = $env{'form.scantron_questnum_start.'.$part.'.'.$id};
 1058:         if (!$startline) {
 1059:             $startline = $Apache::lonxml::counter;
 1060:         }
 1061: 	for ($line = 0; $line < $lines; $line++) {
 1062:             my $theline = $startline+$offset-1+$line;
 1063: 	    $response = $env{"scantron.$theline.answer"};
 1064: 	    if ((defined($response)) && ($response ne "") && ($response ne " ")) {
 1065: 		last;
 1066: 	    }
 1067:  
 1068: 	}
 1069: 
 1070: 	# save bubbled letter for later
 1071: 	$Apache::lonhomework::results{"resource.$part.$id.scantron"}.=
 1072: 	    $response;
 1073: 	if ($resulttype ne 'letter') {
 1074:             $response = $let_to_num{$response};
 1075:             if ($resulttype eq 'A is 1') {
 1076:                 if ($response ne "") {
 1077:                     $response = $response+1;
 1078:                 }
 1079: 	    }
 1080: 	    if ($response ne "") {
 1081: 		$response += $line * $bubbles_per_line;
 1082: 	    }
 1083: 	} else {
 1084: 	    if ($response ne "") {
 1085:                 my $raw = $response;
 1086: 		$response = chr(ord($response) + $line * $bubbles_per_line);
 1087: 	    }
 1088: 	}
 1089: 
 1090:     } else {
 1091: 	$response = $env{$formparm};
 1092:     }
 1093:     # 
 1094:     #  If we have a nonempty answer, correct the numeric value
 1095:     #  of the answer for the line on which it was found.
 1096:     #
 1097: 
 1098:     return $response;
 1099: }
 1100: 
 1101: =pod
 1102: 
 1103: =item &repetition();
 1104: 
 1105: In scalar context:
 1106: 
 1107: returns: the number of lines that are required to encode the weight.
 1108: (Default is for 10 bubbles per bubblesheet item; other (integer) 
 1109: values can be specified by using a custom Bubblesheet format file 
 1110: with an eighteenth entry (BubblesPerRow) set to the integer 
 1111: appropriate for the bubblesheets which will be used to assign weights.
 1112: 
 1113: In array context:
 1114:  
 1115: returns: number of lines required to encode weight, and bubbles/line.
 1116: 
 1117: =cut
 1118: 
 1119: sub repetition {
 1120:     my $id = $Apache::inputtags::part;
 1121:     my $weight = &Apache::lonnet::EXT("resource.$id.weight");
 1122:     if (!defined($weight) || ($weight eq '')) { $weight=1; }
 1123:     my $bubbles_per_row;
 1124:     if (($env{'form.bubbles_per_row'} =~ /^\d+$/) && 
 1125:         ($env{'form.bubbles_per_row'} > 0)) {
 1126:         $bubbles_per_row = $env{'form.bubbles_per_row'};
 1127:     } else {
 1128:         $bubbles_per_row = 10;
 1129:     }
 1130:     my $denominator = $bubbles_per_row;
 1131:     if (($env{'form.scantron_lastbubblepoints'} == 0) && 
 1132:         ($bubbles_per_row > 1)) {
 1133:         $denominator = $bubbles_per_row - 1;
 1134:     } 
 1135:     my $repetition = int($weight/$denominator);
 1136:     if ($weight % $denominator != 0) { $repetition++; } 
 1137:     if (wantarray) {
 1138:         return ($repetition,$bubbles_per_row);
 1139:     }
 1140:     return $repetition;
 1141: 
 1142: }
 1143: 
 1144: =pod
 1145: 
 1146: =item &scored_response();
 1147: 
 1148: Sets the results hash elements
 1149: 
 1150:    resource.$part_id.$response_id.awarded - to the floating point
 1151:      number between 0 and 1 that was awarded on the bubbled input
 1152: 
 1153:    resource.$part_id.$response_id.awarddetail - to 'ASSIGNED_SCORE'
 1154: 
 1155: Returns
 1156: 
 1157:    the number of bubble sheet lines that were used (and likely need to
 1158:      be passed to &Apache::lonxml::increment_counter()
 1159: 
 1160: Arguments
 1161: 
 1162:    $part_id - id of the part to grade
 1163:    $response_id - id of the response to grade
 1164:   
 1165: 
 1166: =cut
 1167: 
 1168: sub scored_response {
 1169:     my ($part,$id)=@_;
 1170:     my $repetition=&repetition();
 1171:     my $bubbles_per_row;
 1172:     if (($env{'form.bubbles_per_row'} =~ /^\d+$/) &&
 1173:         ($env{'form.bubbles_per_row'} > 0)) {
 1174:         $bubbles_per_row = $env{'form.bubbles_per_row'};
 1175:     } else {
 1176:         $bubbles_per_row = 10;
 1177:     }
 1178:     my $score=0;
 1179:     for (my $i=0;$i<$repetition;$i++) {
 1180: 	# A is 1, B is 2, etc.
 1181: 	my $increase=&Apache::response::getresponse($i+1);
 1182:         unless (($increase == $bubbles_per_row-1) &&
 1183:                 ($env{'form.scantron_lastbubblepoints'} == 0)) {
 1184:             # (get response return 0-9 and then we add 1)
 1185:             if ($increase ne '') {
 1186:                 $score+=$increase+1;
 1187:             }
 1188:         }
 1189:     }
 1190:     my $weight = &Apache::lonnet::EXT("resource.$part.weight");
 1191:     if (!defined($weight) || $weight eq '' || $weight eq 0) { $weight = 1; }
 1192:     my $pcr=$score/$weight;
 1193:     $Apache::lonhomework::results{"resource.$part.$id.awarded"}=$pcr;
 1194:     $Apache::lonhomework::results{"resource.$part.$id.awarddetail"}=
 1195: 	'ASSIGNED_SCORE';
 1196:     return $repetition;
 1197: }
 1198: 
 1199: sub whichorder {
 1200:     my ($max,$randomize,$showall,$hash,$rndseed)=@_;
 1201:     #&Apache::lonxml::debug("man $max randomize $randomize");
 1202:     my @names;
 1203:     if (ref($hash->{'names'}) eq 'ARRAY') {
 1204:         @names = @{$hash->{'names'}};
 1205:     }
 1206:     return if (!@names);
 1207:     my @whichopt =();
 1208:     my (%top,@toplist,%bottom,@bottomlist);
 1209:     if (!($showall || ($randomize eq 'no'))) {
 1210: 	my $current=0;
 1211: 	foreach my $name (@names) {
 1212: 	    $current++;
 1213: 	    if ($$hash{"$name.location"} eq 'top') {
 1214: 		$top{$name}=$current;
 1215: 	    } elsif ($$hash{"$name.location"} eq 'bottom') {
 1216: 		$bottom{$name}=$current;
 1217: 	    }
 1218: 	}
 1219:     }
 1220:     my $topcount=0;
 1221:     my $bottomcount=0;
 1222:     while (((scalar(@whichopt)+$topcount+$bottomcount) < $max || $showall)
 1223: 	   && ($#names > -1)) {
 1224: 	#&Apache::lonxml::debug("Have $#whichopt max is $max");
 1225: 	my $aopt;
 1226: 	if ($showall || ($randomize eq 'no')) {
 1227: 	    $aopt=0;
 1228: 	} else {
 1229: 	    $aopt=int(&Math::Random::random_uniform() * ($#names+1));
 1230: 	}
 1231: 	#&Apache::lonxml::debug("From $#whichopt $max $#names elms, picking $aopt");
 1232: 	$aopt=splice(@names,$aopt,1);
 1233: 	#&Apache::lonxml::debug("Picked $aopt");
 1234: 	if ($top{$aopt}) {
 1235: 	    $toplist[$top{$aopt}]=$aopt;
 1236: 	    $topcount++;
 1237: 	} elsif ($bottom{$aopt}) {
 1238: 	    $bottomlist[$bottom{$aopt}]=$aopt;
 1239: 	    $bottomcount++;
 1240: 	} else {
 1241: 	    push (@whichopt,$aopt);
 1242: 	}
 1243:     }
 1244:     for (my $i=0;$i<=$#toplist;$i++) {
 1245: 	if ($toplist[$i]) { unshift(@whichopt,$toplist[$i]) }
 1246:     }
 1247:     for (my $i=0;$i<=$#bottomlist;$i++) {
 1248: 	if ($bottomlist[$i]) { push(@whichopt,$bottomlist[$i]) }
 1249:     }
 1250:     return @whichopt;
 1251: }
 1252: 
 1253: sub show_answer {
 1254:     my $part   = $Apache::inputtags::part;
 1255:     my $award  = $Apache::lonhomework::history{"resource.$part.solved"};
 1256:     my $status = $Apache::inputtags::status[-1];
 1257:     my $canshow = 0;
 1258:     if ($award =~ /^correct/) {
 1259:         if (($Apache::lonhomework::history{"resource.$part.awarded"} >= 1) ||
 1260:             (&Apache::lonnet::EXT("resource.$part.retrypartial") !~/^1|on|yes$/)) {
 1261:             $canshow = 1;
 1262:         }   
 1263:     }
 1264:     return  (($canshow && &Apache::lonhomework::show_problem_status()) 
 1265: 	     || $status eq "SHOW_ANSWER");
 1266: }
 1267: 
 1268: sub analyze_store_foilgroup {
 1269:     my ($shown,$attrs)=@_;
 1270:     my $part_id="$Apache::inputtags::part.$Apache::inputtags::response[-1]";
 1271:     foreach my $name (@{ $Apache::response::foilgroup{'names'} }) {
 1272: 	if (defined($Apache::lonhomework::analyze{"$part_id.foil.value.$name"})) { next; }
 1273: 	push (@{ $Apache::lonhomework::analyze{"$part_id.foils"} },$name);
 1274: 	foreach my $attr (@$attrs) {
 1275: 	    $Apache::lonhomework::analyze{"$part_id.foil.".$attr.".$name"} =
 1276: 		$Apache::response::foilgroup{"$name.".$attr};
 1277: 	}
 1278:     }
 1279:     push (@{ $Apache::lonhomework::analyze{"$part_id.shown"} }, @{ $shown });
 1280: }
 1281: 
 1282: sub check_if_computed {
 1283:     my ($token,$parstack,$safeeval,$name)=@_;
 1284:     my $value = &Apache::lonxml::get_param($name,$parstack,$safeeval);
 1285:     if (ref($token->[2]) eq 'HASH' && $value ne $token->[2]{$name}) {
 1286: 	my $part_id="$Apache::inputtags::part.$Apache::inputtags::response[-1]";
 1287: 	$Apache::lonhomework::analyze{"$part_id.answercomputed"} = 1;
 1288:     }
 1289: }
 1290: 
 1291: sub pick_foil_for_concept {
 1292:     my ($target,$attrs,$hinthash,$parstack,$safeeval)=@_;
 1293:     my @names;
 1294:     if (ref($Apache::response::conceptgroup{'names'}) eq 'ARRAY') {
 1295:         @names = @{ $Apache::response::conceptgroup{'names'} };
 1296:     }
 1297:     return if (!@names);
 1298:     my $pick=int(&Math::Random::random_uniform() * ($#names+1));
 1299:     my $name=$names[$pick];
 1300:     push @{ $Apache::response::foilgroup{'names'} }, $name;
 1301:     foreach my $attr (@$attrs) {
 1302: 	$Apache::response::foilgroup{"$name.".$attr} =
 1303: 	    $Apache::response::conceptgroup{"$name.".$attr};
 1304:     }
 1305:     my $concept = &Apache::lonxml::get_param('concept',$parstack,$safeeval);
 1306:     $Apache::response::foilgroup{"$name.concept"} = $concept;
 1307:     &Apache::lonxml::debug("Selecting $name in $concept");
 1308:     my $part_id="$Apache::inputtags::part.$Apache::inputtags::response[-1]";
 1309:     if ($target eq 'analyze') {
 1310: 	push (@{ $Apache::lonhomework::analyze{"$part_id.concepts"} },
 1311: 	      $concept);
 1312: 	$Apache::lonhomework::analyze{"$part_id.concept.$concept"}=
 1313: 	    $Apache::response::conceptgroup{'names'};
 1314: 	foreach my $name (@{ $Apache::response::conceptgroup{'names'} }) {
 1315: 	    push (@{ $Apache::lonhomework::analyze{"$part_id.foils"} },
 1316: 		  $name);
 1317: 	    foreach my $attr (@$attrs) {
 1318: 		$Apache::lonhomework::analyze{"$part_id.foil.$attr.$name"}=
 1319: 		    $Apache::response::conceptgroup{"$name.$attr"};
 1320: 	    }
 1321: 	}
 1322:     }
 1323:     push(@{ $hinthash->{"$part_id.concepts"} },$concept);
 1324:     $hinthash->{"$part_id.concept.$concept"}=
 1325: 	$Apache::response::conceptgroup{'names'};
 1326: 
 1327: }
 1328: 
 1329: =pod
 1330: 
 1331: =item get_response_param()
 1332: 
 1333: Get a parameter associated with a problem.
 1334: Parameters:
 1335: 	$id        - the id of the paramater, either a part id, 
 1336:               or a partid and responspe id joined by _
 1337: 	$name      - Name of the parameter to fetch
 1338: 	$default   - Default value for the paramter.
 1339: 
 1340: =cut
 1341: 
 1342: sub get_response_param {
 1343:     my ($id,$name,$default)=@_;
 1344:     my $parameter;
 1345:     if ($env{'request.state'} eq 'construct' &&
 1346: 	defined($Apache::inputtags::params{$name})) {
 1347: 	$parameter=$Apache::inputtags::params{$name};
 1348:     } else {
 1349: 	$parameter=&Apache::lonnet::EXT("resource.$id.$name");
 1350:     }
 1351:     if (!defined($parameter) ||	$parameter eq '') {
 1352: 	$parameter = $default;
 1353:     }
 1354:     return $parameter;
 1355: }
 1356: 
 1357: sub submitted {
 1358:     my ($who)=@_;
 1359:     
 1360:     # when scatron grading any submission is a submission
 1361:     if ($env{'form.submitted'} eq 'scantron') { return 1; }
 1362:     # if the caller only cared if this was a scantron submission
 1363:     if ($who eq 'scantron') { return 0; }
 1364:     # if the Submit Answer button for this particular part was pressed
 1365:     my $partid=$Apache::inputtags::part;
 1366:     if ($env{'form.submitted'} eq "part_$partid") {
 1367: 	return 1;
 1368:     }
 1369:     if ($env{'form.submitted'} eq "yes"
 1370: 	&& defined($env{'form.submit_'.$partid})) {
 1371: 	return 1;
 1372:     }
 1373:     # Submit All button on a .page was pressed
 1374:     if (defined($env{'form.all_submit'})) { return 1; }
 1375:     # otherwise no submission occurred
 1376:     return 0;
 1377: }
 1378: 
 1379: sub add_to_gradingqueue {
 1380:     my ($symb,$courseid,$domain,$name) = &Apache::lonnet::whichuser();
 1381:     if (   $courseid eq ''
 1382: 	|| $symb eq ''
 1383: 	|| $env{'request.state'} eq 'construct'
 1384: 	|| $Apache::lonhomework::type ne 'problem') {
 1385: 	return;
 1386:     }
 1387: 
 1388:     my %queue_info = ( 'type' => 'problem',
 1389: 		       'time' => time);
 1390: 
 1391:     if (exists($Apache::lonhomework::history{"resource.0.checkedin.slot"})) {
 1392: 	$queue_info{'slot'}=
 1393: 	     $Apache::lonhomework::history{"resource.0.checkedin.slot"};
 1394:     }
 1395: 
 1396:     my $result=&Apache::bridgetask::add_to_queue('gradingqueue',\%queue_info);
 1397:     if ($result ne 'ok') {
 1398: 	&Apache::lonxml::error("add_to_queue said $result");
 1399:     }
 1400: }
 1401: 
 1402: =pod 
 1403: 
 1404: =item check_status()
 1405: 
 1406: basically undef and 0 (both false) mean that they still have work to do
 1407: and all true values mean that they can't do any more work
 1408: 
 1409: 	a return of undef means it is unattempted
 1410: 	a return of 0 means it is attmpted and wrong but still has tries
 1411: 	a return of 1 means it is marked correct
 1412: 	a return of 2 means they have exceed maximum number of tries
 1413: 	a return of 3 means it after the answer date
 1414: 
 1415: =cut
 1416: 
 1417: sub check_status {
 1418:     my ($id)=@_;
 1419:     if (!defined($id)) { $id=$Apache::inputtags::part; }
 1420:     my $curtime=&Apache::lonnet::EXT('system.time');
 1421:     my $opendate=&Apache::lonnet::EXT("resource.$id.opendate");
 1422:     my $duedate=&Apache::lonhomework::due_date($id);
 1423:     my $answerdate=&Apache::lonnet::EXT("resource.$id.answerdate");
 1424:     if ( $opendate && $curtime > $opendate &&
 1425:          $duedate && $curtime > $duedate &&
 1426:          $answerdate && $curtime > $answerdate) {
 1427:         return 3;
 1428:     }
 1429:     my $status=&Apache::lonnet::EXT("user.resource.resource.$id.solved");
 1430:     if ($status =~ /^correct/) { return 1; }
 1431:     if (!$status) { return undef; }
 1432:     my $maxtries=&Apache::lonnet::EXT("resource.$id.maxtries");
 1433:     if ($maxtries eq '') { $maxtries=2; }
 1434:     my $curtries=&Apache::lonnet::EXT("user.resource.resource.$id.tries");
 1435:     if ($curtries < $maxtries) { return 0; }
 1436:     return 2;
 1437: }
 1438: 
 1439: =pod
 1440: 
 1441: =item setup_prior_tries_hash()
 1442: 
 1443:   Foreach each past .submission $func is called with 3 arguments
 1444:      - the mode to set things up for (currently always 'grade')
 1445:      - the stored .submission string
 1446:      - The expansion of $data
 1447: 
 1448:   $data is an array ref containing elements that are either
 1449:     - scalars that are other elements of the history hash to pass to $func
 1450:     - ref to data to be passed untouched to $func
 1451: 
 1452:   $questiontype is the questiontype (currently only passed in if
 1453:       randomizebytry.
 1454: 
 1455: =cut
 1456: 
 1457: sub setup_prior_tries_hash {
 1458:     my ($func,$data,$questiontype) = @_;
 1459:     my $part = $Apache::inputtags::part;
 1460:     my $id   = $Apache::inputtags::response[-1];
 1461:     foreach my $i (1..$Apache::lonhomework::history{'version'}) {
 1462:         my $partprefix = "$i:resource.$part";
 1463: 	my $sub_key   = "$partprefix.$id.submission";
 1464: 	next if (!exists($Apache::lonhomework::history{$sub_key}));
 1465:         my $type_key = "$partprefix.type";
 1466:         my $type = $Apache::lonhomework::history{$type_key};
 1467: 	my @other_data;
 1468:         if (ref($data) eq 'ARRAY') {
 1469: 	    foreach my $datum (@{ $data }) {
 1470: 	        if (ref($datum)) {
 1471: 		    push(@other_data,$datum);
 1472: 	        } else {
 1473: 		    my $info_key = "$i:resource.$part.$id.$datum";
 1474: 		    push(@other_data,$Apache::lonhomework::history{$info_key});
 1475: 	        }
 1476: 	    }
 1477:         }
 1478:         if ($questiontype eq 'randomizetry') { 
 1479:             my $order_key = "$partprefix.$id.foilorder";
 1480:             my @whichopts = &Apache::lonnet::str2array($Apache::lonhomework::history{$order_key});
 1481:             if (@whichopts > 0) {
 1482:                 shift(@other_data);
 1483:                 unshift(@other_data,\@whichopts);
 1484:             }
 1485:         }
 1486: 	my $output =
 1487: 	    &$func('grade',
 1488: 		   $Apache::lonhomework::history{$sub_key},
 1489: 		   \@other_data);
 1490: 	if (defined($output)) {
 1491: 	    $Apache::inputtags::submission_display{$sub_key} = $output;
 1492: 	}
 1493:     }
 1494: }
 1495: 
 1496: 1;
 1497: __END__
 1498:  
 1499: =pod
 1500: 
 1501: =cut

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