Return to Domain_Configuration_Scantron_Format.tex CVS log

Up to [LON-CAPA] / loncom / html / adm / help / tex

Annotation of loncom/html/adm/help/tex/Domain_Configuration_Scantron_Format.tex, revision 1.6

1.1       raeburn     1: \label{Domain_Configuration_Scantron_Format}
1.4       raeburn     2: Where bubblesheet exams are used in a course, the format of data in the
                      3: file generated from the processing of bubbled-in bubblesheets may
1.1       raeburn     4: vary between institutions. The format definitions available when performing
1.4       raeburn     5: bubblesheet grading in LON-CAPA were originally listed in the scantronformat.tab
1.1       raeburn     6: file, stored in /home/httpd/lonTabs, which might have been modified
                      7: locally on each server. 
                      8: 
1.4       raeburn     9: Starting with LON-CAPA 2.7, bubblesheet format information is read from
1.1       raeburn    10: either a custom.tab file, or a default.tab file both of which belong
                     11: to the special domain configuration user (\$dom-domainconfig, where
                     12: \$dom is the name of the domain) and which are automatically published
                     13: into resource space. 
                     14: 
                     15: For LON-CAPA installations older than 2.7, when the primary library
                     16: server for the domain has been updated, a Domain Coordinator should
1.3       raeburn    17: display the \char`\"{}Bubblesheet format file\char`\"{} configuration
1.1       raeburn    18: page via \char`\"{}Domain Configuration\char`\"{}. The first time
                     19: this page is displayed, a default.tab (a copy of the standard LON-CAPA
                     20: scantronformat.tab file), and a custom.tab (if the scantronform.tab
                     21: file currently on the server differs from the standard file) will
1.4       raeburn    22: be copied and published. Thereafter any changes to bubblesheet format
                     23: files to be used for grading bubblesheet exams in courses from the domain
1.1       raeburn    24: will be made via the Domain Configuration menu. Any scantronform.tab
                     25: files in /home/httpd/lonTab directories on servers in the domain will
                     26: no longer be used.
                     27: 
1.3       raeburn    28: The settings available via \char`\"{}Bubblesheet format file\char`\"{}
1.1       raeburn    29: support upload of a new custom file, or deletion of an existing custom
                     30: file (in which case grading will default to use of the default.tab
1.4       raeburn    31: file). An uploaded bubblesheet format file contains one or more lines
1.1       raeburn    32: of colon-separated values for the parameters in the following order:
                     33: 
1.5       raeburn    34: \begin{quote}
                     35: {\scriptsize name:description:CODEtype:CODEstart:CODElength:IDstart:IDlength:Qstart:Qlength:Qoff:Qon:PaperID:PaperIDlength:}
                     36: {\scriptsize FirstName:FirstNamelength:LastName:LastNamelength} 
                     37: \end{quote}
1.1       raeburn    38: 
1.6     ! bisitz     39: \begin{enumerate}
        !            40: \item \emph{name} is the internal identifier used within LON-CAPA
        !            41: \item \emph{description} is the text displayed for each option in
1.3       raeburn    42: the {}``Format of data file'' dropdown in the Bubblesheet grading
1.4       raeburn    43: screen.  The user will choose the appropriate format for the bubblesheet 
                     44: file currently being used for bubblesheet grading.
1.6     ! bisitz     45: \item \emph{CODEtype} can be either 'none' 'letter' 'number' 
        !            46: \item \emph{CODEstart}: (only matters if a CODE exists) column in the line where the CODE starts
        !            47: \item \emph{CODElength}: length of the CODE
        !            48: \item \emph{IDstart}: column where the student ID starts
        !            49: \item \emph{IDlength}: length of the student ID
        !            50: \item \emph{Qstart}: column where the information from the bubbled 'questions' start  
        !            51: \item \emph{Qlength} is the number of characters in the raw data used to record the student's bubbled answer for each row on the bubblesheet.
        !            52: 
        !            53: If the raw data indicate bubble position by a letter or a number (e.g., A = first bubble or 1 = first bubble etc.) then the number of characters would be 1 (assuming 10 bubbles or less for the number case).  If however, bubble position is indicated by position of the Qon (bubbled) character, then each bubble row might have 10 characters (one for each of the 10 possible positions with Qon at the position bubbled and Qoff elsewhere, (e.g. if Qon = 1, Qoff = .  the portion of a student's record for a single bubble row might be:  ...1......  indicating position 4 was the one bubbled.
        !            54: \item \emph{Qoff} is the character used to indicate an unfilled bubble, this is commonly a single blank space.
        !            55: \item \emph{Qon} is the character used in the raw data generated by the bubblesheet scanner to indicate a filled-in bubble.
1.1       raeburn    56: 
1.6     ! bisitz     57: \emph{Qon} can be either:
1.1       raeburn    58: \begin{itemize}
                     59: \item the symbol that says a bubble has been selected, or
                     60: \item 'letter' (for when the selected letter appears), or 
                     61: \item 'number' for when a number indicating the selected letter appears 
                     62: \end{itemize}
1.6     ! bisitz     63: \item \emph{PaperID}: if the scanning process generates a unique number for each sheet scanned the column that this ID number starts in
        !            64: \item \emph{PaperIDlength}: number of columns that comprise the unique ID number for the sheet of paper
        !            65: \item \emph{FirstName}: column that the first name starts in
        !            66: \item \emph{FirstNamelength}: number of columns that the first name spans
        !            67: \item \emph{LastName}: column that the last name starts in
        !            68: \item \emph{LastNamelength}: number of columns that the last name spans
        !            69: \end{enumerate}
1.1       raeburn    70: As an example, below are four different format lines: the first two
                     71: were used at MSU prior to 2006; the last two have been used since
                     72: then.
                     73: 
                     74: \begin{itemize}
                     75: \item msunocode:MSU without any CODE:none:0:0:57:9:77:10: :1:5:5:51:1:41:10 
                     76: \item msucode:MSU with CODE in separate location:letter:69:6:57:9:77:10:
                     77: :1:5:5:51:1:41:10 
                     78: \item msucodelet:MSU with CODE in separate location (letter format):-1:69:6:57:9:77:1:
                     79: :letter:5:5:51:1:41:10 
                     80: \item msucodenum:MSU with CODE in separate location (number format):-1:69:6:57:9:77:1:
                     81: :number:5:5:51:1:41:10
                     82: \end{itemize}