[LON-CAPA-cvs] cvs: loncom /html/adm/help/tex Domain_Configuration_Scantron_Format.tex

[bisitz]

bisitz		Tue Aug  2 16:24:39 2011 EDT

  Modified files:              
    /loncom/html/adm/help/tex	Domain_Configuration_Scantron_Format.tex 
  Log:
  - Complete documentation about bubblesheet format field explanations by adding missing descriptions
  Information taken from code documetation within grades.pm and from e-mail on lon-capa-users ML, "Bubble sheets", Stuart Raeburn, 02.02.2009
  - Additional improvments, e.g. highlight field names, use ordered list, correct typo
  
  
  
Index: loncom/html/adm/help/tex/Domain_Configuration_Scantron_Format.tex
diff -u loncom/html/adm/help/tex/Domain_Configuration_Scantron_Format.tex:1.5 loncom/html/adm/help/tex/Domain_Configuration_Scantron_Format.tex:1.6
--- loncom/html/adm/help/tex/Domain_Configuration_Scantron_Format.tex:1.5	Thu May 26 11:56:22 2011
+++ loncom/html/adm/help/tex/Domain_Configuration_Scantron_Format.tex	Tue Aug  2 16:24:39 2011
@@ -36,21 +36,37 @@
 {\scriptsize FirstName:FirstNamelength:LastName:LastNamelength} 
 \end{quote}
 
-\begin{itemize}
-\item name is the internal identifier used within LON-CAPA
-\item description is the text displayed for each option in the   
+\begin{enumerate}
+\item \emph{name} is the internal identifier used within LON-CAPA
+\item \emph{description} is the text displayed for each option in
 the {}``Format of data file'' dropdown in the Bubblesheet grading
 screen.  The user will choose the appropriate format for the bubblesheet 
 file currently being used for bubblesheet grading.
-\item CODEtype can be either 'none' 'letter' 'number' 
-\item Qon can be either:
+\item \emph{CODEtype} can be either 'none' 'letter' 'number' 
+\item \emph{CODEstart}: (only matters if a CODE exists) column in the line where the CODE starts
+\item \emph{CODElength}: length of the CODE
+\item \emph{IDstart}: column where the student ID starts
+\item \emph{IDlength}: length of the student ID
+\item \emph{Qstart}: column where the information from the bubbled 'questions' start  
+\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.
+
+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.
+\item \emph{Qoff} is the character used to indicate an unfilled bubble, this is commonly a single blank space.
+\item \emph{Qon} is the character used in the raw data generated by the bubblesheet scanner to indicate a filled-in bubble.
 
+\emph{Qon} can be either:
 \begin{itemize}
 \item the symbol that says a bubble has been selected, or
 \item 'letter' (for when the selected letter appears), or 
 \item 'number' for when a number indicating the selected letter appears 
 \end{itemize}
-\end{itemize}
+\item \emph{PaperID}: if the scanning process generates a unique number for each sheet scanned the column that this ID number starts in
+\item \emph{PaperIDlength}: number of columns that comprise the unique ID number for the sheet of paper
+\item \emph{FirstName}: column that the first name starts in
+\item \emph{FirstNamelength}: number of columns that the first name spans
+\item \emph{LastName}: column that the last name starts in
+\item \emph{LastNamelength}: number of columns that the last name spans
+\end{enumerate}
 As an example, below are four different format lines: the first two
 were used at MSU prior to 2006; the last two have been used since
 then.