Return to analyze_structure CVS log

Up to [LON-CAPA] / doc / homework

Add docs for $prefix.bubble_lines element of the analysis hash.

    1: parts - array of identifiers for responses that have registered
    2:         themselves in order that they occur in the problem.
    3: 	The identifiers have the format
    4: 
    5:    $part_id.$response_id
    6:        
    7:         and they will prefix all other keys that are associated with the 
    8:         associated response
    9: 
   10: 
   11: For the rest of the keys $prefix will be a entry from the above parts array
   12: 
   13:     - $prefix.answercomputed - will be set to 1 if it's been detected
   14:                                that the correct answer is calculated (and
   15:                                then likely to vary on a per student basis)
   16:                                or statically set (and thus likely the same
   17:                                for each student)
   18: 
   19:    - $prefix.bubble_lines    - Number of lines of bubbles in a scantron
   20:                                sheet required for this response.  This is used
   21:                                to know exactly what it means to multiply bubble
   22:                                or to not have bubbles for a response in exam
   23:                                mode taken on scantron sheets.
   24: 
   25: <numerical/formularesponse>
   26: 
   27:     - $prefix.type - either 'numericalresponse or 'formularesponse'
   28: 
   29:     - $prefix.incorrect - array of the values that are in the incorrect
   30:                           attribute for a numericalresponse 
   31: 
   32: 
   33:     For each of these, the value is a hash, with keys that are the
   34:     value of the name attribute of the associated <answer>, the value
   35:     of that is an array for each component of the answer
   36: 
   37:     For example
   38: 
   39:      $analyze{"$prefix.answer"}{$name}[1]
   40: 
   41:     is the second component of the ansser $name for the response $prefix
   42: 
   43: 
   44:         - $prefix.answer   - the correct answer
   45:         - $prefix.unit     - the unit for the correct answer
   46:         - $prefix.ans_high - for ranged answers the highest allowed answer
   47:         - $prefix.ans_low  - for ranged answers the lowest allowed answer
   48:         - $prefix.format   - the format specification for displaying the
   49:                              correct answer
   50: 
   51: 
   52: <stringresponse>
   53: 
   54:     - $prefix.type - will be 'stringresponse'
   55: 
   56:     For each of these, the value is a hash, with keys that are the
   57:     value of the name attribute of the associated <answer>, the value of
   58:     that is an array for each component of the answer
   59: 
   60:     For example
   61: 
   62:       $analyze{"$prefix.answer"}{$name}[1]
   63: 
   64:     is the second component of the answser $name for the response $prefix
   65: 
   66:         - $prefix.answer   - the correct answer
   67:         - $prefix.str_type - the type of answer (either 'mc' 'cs' 'ci' 're')
   68: 
   69: 
   70: 
   71: 
   72: <image/match/option/radiobutton/rank response>
   73: 
   74:     - $prefix.foils - a list of all names seen from the <foil>s name attribute
   75:     - $prefix.shown - a list of all <foil> names that were actually shown to
   76:                      this user (in the order that they were displayed to them)
   77: 
   78:     - $prefix.concepts - (only appears if <conceptgroup> is used) 
   79:                      a list of all the concept attributes for each
   80:                      <conceptgroup>s that appears 
   81: 
   82:     For each of the possible <conceptgroup> concepts from the
   83:     $prefix.concepts array there is a
   84: 
   85:         - $prefix.concept.$concept - the array of <foil> names associated 
   86:                                      with $concept
   87: 
   88:     For each of the possible <foil> names from the $prefix.foils array
   89:     there is a
   90: 
   91:         - $prefix.foil.value.$name - the correct value for this <foil> (from
   92:                                      the <foil>'s value attribute)
   93: 
   94:         - $prefix.foil.text.$name - the text that was displayed to the student
   95:                                     as the text for this foil
   96: 
   97:     For <rank/radiobutton/option/match response> there is also
   98: 
   99:         - $prefix.foil.location.$name - the value of the location
  100:                                         attribute for the
  101:                                         value tag (expected to be
  102:                                         either 'top',
  103:                                        'bottom', or 'random' if blank,
  104:                                        assumed to be 'random' 
  105: 
  106: 
  107: 
  108: <imageresponse>
  109:     - $prefix.foil.image.$name - the url of the image that is displayed
  110:                                  to the user
  111: 
  112:     - $prefix.foil.area.$name - the area of the image that is set as correct
  113: 
  114: 
  115: <matchresponse>
  116: 
  117:     - $prefix.items - array of the names of the <item>s 
  118: 
  119: <optionresponse>
  120: 
  121:     - $prefix.options - array of all possible selectable options 
  122:                         (from the <foilgroup>)
  123: 
  124: <radiobuttonresponse>
  125: 
  126:     - $prefix.options - array of all possible selectable options 
  127:                         (which will always be 'true' and 'false')
  128: 
  129: 
  130: <rankresponse>
  131: 
  132:     - $prefix.tol - the tolerance to apply when checking if two <foil>s
  133:                     are equivalent or not
  134: 
  135: