Return to datastorage CVS log

Up to [LON-CAPA] / doc / homework

- adding docs about the resource level .awarded that can get set

    1: ----PARAMETERS-----
    2: <see also packages.tab>
    3: resource.partid.opendate   #unix time of when the local machine should let the
    4:                     #student in
    5: 
    6: resource.partid.duedate    #unix time of when the local machine should stop
    7:                     #accepting answers
    8: 
    9: resource.partid.answerdate #unix time of when the local machine should
   10:                     #provide the correct answer to the student
   11: 
   12: resource.partid.acc # a string that can be used to control access, either
   13:                     # IP based or Domain Name based
   14: 
   15: resource.partid.weight     # points the problem is worth
   16: 
   17: resource.partid.maxtries   # maximum number of attempts the student can have
   18: 
   19: 
   20: resource.partid.problemstyle (notcurrently supported)
   21:                              # style to show a problem in, possible values:
   22:                              # online - show problem in default online mode
   23:                              # bubble - show problem in a mode approriate to
   24:                              #          being printed out for a bubble sheet
   25:                              #          exam
   26:                              # checkout - do checkouting of problem
   27: 
   28: resource.partid.type       # type of problem homework can be:
   29:                            # homework - randomized, graded, stored with 
   30:                            #            requesting user, full feeback
   31:                            # exam - randomized, graded, stored with 
   32:                            #        requesting user, minimal feedback
   33:                            # form - unrandomized, ungraded, stored with 
   34:                            #        specified user, full feedback
   35:                            # survey - unrandomized, ungraded, stored with 
   36:                            #          requesting user, full feedback
   37: 
   38: 
   39: <numerical/formula/response needed: (has a default if nonexistant)>
   40: 
   41: resource.partid.responseid.tol   # lots of possibilities here
   42:                     # percentage, range (inclusive and exclusive),
   43: 		    # variable name, etc
   44:                     # 3%
   45:                     # 0.5
   46:                     # .05+
   47:                     # 3%+
   48:                     # 0.5+,.005
   49: 
   50: resource.partid.responseid.sig  # one or two comma sepearted integers, specifying the
   51:                      # number of significatn figures a student must use
   52: 
   53: 
   54: <essayresponse specific>
   55: 
   56: resource.partid.responseid.maxcollaborators
   57:                      	# integer of the maximum number of users to 
   58:                         # collborate on an answer
   59: 
   60: resource.partid.responseid.uploadfiletypes
   61:                         # a comma seperated list of filetypes to allow a user
   62:                         # to upload
   63: 
   64: 
   65: 
   66: ----STORED VALUES----
   67: resource.partid.solved # if not set, problem yet to be viewed
   68:                 # incorrect_attempted == incorrect and attempted
   69:                 # correct_by_student == correct by student work
   70:                 # correct_by_override == correct, instructor override
   71:                 # correct_by_scantron == correct, scantron graded
   72:                 # incorrect_by_override == incorrect, instructor override
   73:                 # excused == excused, problem no longer counts for student
   74:                 # '' (empty) == not attempted
   75:                 # ungraded_attempted == an ungraded answer has been
   76:                                           submitted and stored
   77: resource.partid.tries  # positive integer of number of unsuccessful attempts
   78:                 # made, malformed answers don't count if feedback is
   79:                 # on
   80: 
   81: resource.partid.awarded # float between 0 and 1, percentage of
   82:                         # resource.partid.weight that the student earned.
   83: 
   84: <only exists in the scantron grading case>
   85: resource.partid.resourceid.awarded
   86:                          # float between 0 and 1, percentage of
   87:                          # resource.partid.weight
   88:                          # that the student was assigned on a scantron sheet
   89:                          # all resource level .awarded s will be averaged
   90:                          # together for the final part .awarded
   91: 
   92: resource.partid.award # final detailed award that was applied to the entire
   93:                       # part of the question, check awarddetail below for
   94:                       # possibilities
   95: 
   96: resource.partid.previous # boolean, is this submission a previous submission
   97: 
   98: resource.partid.regrader
   99:                  # the username:domain of the user who hand graded this one
  100: 
  101: 
  102: resource.partid.afterduedate
  103:                  # the award that would have been received if they had
  104:                  # submitted before the duedate
  105: 
  106: resource.partid.responseid.submisson
  107:                     # the student submitted string for the part.response
  108: 
  109: resource.partid.responseid.awarddetail
  110:                      # list of all of the results of grading the submissions
  111:                      # in detailed form of the specific failure
  112: 		     #Possible values:
  113:                      # EXACT_ANS, APPROX_ANS : student is correct
  114:                      # NO_RESPONSE : student submitted no response
  115:                      # MISSING_ANSWER : student submitted some but not
  116:                      #                   all parts of a response
  117:                      # WANTED_NUMERIC : expected a numeric answer and
  118:                      #                   didn't get one
  119: 		     # SIG_FAIL : incorrect number of Significant Figures
  120:                      # UNIT_FAIL : incorrect unit
  121:                      # UNIT_NOTNEEDED : Submitted a unit when one shouldn't
  122:                      # NO_UNIT : needed a unit but none was submitted
  123: 		     # BAD_FORMULA : syntax error in submitted formula
  124:                      # INCORRECT : answer was wrong
  125:                      # SUBMITTED : submission wasn't graded
  126:                      # DRAFT : submission only stored
  127:                      # MISORDERED_RANK : student submitted a poorly order
  128:                      #                   rank response
  129: 		     # ERROR : unable to get a grade
  130:                      # ASSIGNED_SCORE : there is a 
  131:                      #                  resource.partid.responseid.awarded
  132:                      #                  the real awarded should be set to the
  133:                      #                  average of the individual awardeds
  134:                      # TOO_LONG : answer submission to capa engine longer
  135:                      #            than 500 characters
  136:                      # INVALID_FILETYPE : student tried to upload a file
  137:                      #                    that was of an extension that was
  138:                      #                    not specficy allowed 
  139: 
  140: resource.partid.responseid.message (optional) (not yet supported)
  141: 		     # a message that should be shown to the student
  142: 
  143: resource.partid.bonustries (optional) (not yet supported)
  144:                      # if set, added to the maxtries parameter for student 
  145:                      # total number of tries overall
  146: 
  147: resource.partid.responseid.scantron
  148:                  # the letteror string that the scantron submitted as 
  149:                  # the answer before it was converted into the submission
  150:                  # value
  151: 
  152: rndseed
  153:                  # for public users or browsed versions, the rndseed used
  154:                  # for this partcualr submission, should only appear
  155:                  # in tmpstore dbs
  156: 
  157: <option/rank/match response specific>
  158: resource.partid.responseid.submissiongrading
  159: 		 # an annotation of which foils that the student
  160:                  # submitted were wrong and which were correct (hash)
  161: 
  162: <optionresponse> specific
  163: resource.partid.responseid.numfoils
  164:                      # if graded in scantron mode this is set to number
  165:                      # of foils a student saw
  166: 
  167: <organicresponse specific>
  168: resource.partid.responseid.molecule
  169:                      #JME string of the last submission
  170: 
  171: <essayresponse> specific
  172: resource.partid.responseid.uploadedfile
  173:                      # filename of the upload file that is to be used
  174:                      # for the submission
  175: 
  176: resource.partid.responseid.uploadedurl
  177:                     # url to use to grab the file that was used for
  178:                     # the submission
  179: 
  180: resource.partid.responseid.portfiles
  181:                     # comma sepearted list of student portfolio files
  182:                     # for the submission
  183: 
  184: