%% This document created by Scientific Notebook (R) Version 3.0


\documentclass[12pt,thmsa]{article}
\usepackage{amssymb}

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\usepackage{sw20jart}

%TCIDATA{TCIstyle=article/art4.lat,jart,sw20jart}

%TCIDATA{<META NAME="ViewSettings" CONTENT="23">}
%TCIDATA{<META NAME="GraphicsSave" CONTENT="32">}
%TCIDATA{<META NAME="Title" CONTENT="Ch 4: Creating the Front Section of an Exam">}
%TCIDATA{Created=Mon Aug 19 14:52:24 1996}
%TCIDATA{LastRevised=Mon Feb 17 12:38:07 1997}
%TCIDATA{Language=American English}
%TCIDATA{CSTFile=booklet.cst}
%TCIDATA{PageSetup=72,72,72,72,1}
%TCIDATA{<LINK REL="author" HREF="EBfront.tex">}
%TCIDATA{<LINK REL="contents" HREF="EBcontents.tex">}
%TCIDATA{<LINK REL="copyright" HREF="EBfront.tex">}
%TCIDATA{<LINK REL="end" HREF="EBIndex.tex">}
%TCIDATA{<LINK REL="index" HREF="EBIndex.tex">}
%TCIDATA{<LINK REL="next" HREF="EBquestion.tex">}
%TCIDATA{<LINK REL="parent" HREF="EBcontents.tex">}
%TCIDATA{<LINK REL="previous" HREF="EBsource.tex">}
%TCIDATA{<LINK REL="publisher" HREF="EBfront.tex">}
%TCIDATA{<LINK REL="top" HREF="EBcontents.tex">}
%TCIDATA{<LINK REL="trademark" HREF="EBfront.tex">}

\input{tcilatex}
\begin{document}


\subsection{\textit{Chapter 4 \hrulefill }}

\quad

\section{Creating the Front Section of an Exam\label%
{Creating the Front Section}}

The front section identifies the file as an Exam Builder source file and
includes specifications that the Exam Builder uses when it generates the
exam. Although the front section doesn't have to contain any information
other than a heading, it usually contains the text that you want to appear
at the top of each generated exam, such as the exam title, a place for the
student's name, or instructions to the student. Also, the front section
usually includes setup information for the exam. Setup information specifies
what title to display in the title bar when the exam is delivered online,
formatting information (such as how much space to leave between
multiple-choice answers), and definitions of variables used throughout the
exam. The front section can also contain comments for the author's use only.
Comments don't appear in the generated exam. Each kind of information has
its own section within the front section.

Much of the information that can appear in the front section of a source
file can also appear in subsequent question sections. In these cases, this
information is local. That is, the Exam Builder applies it to the section in
which it is specified. If you specify information in the front section, it
applies to the exam as a whole. If you specify information in a question
section, it applies to that question only. If you specify the same kind of
information in both places, the information specified for the question
overrides that specified for the exam.

For example, you might specify in the front section that multiple-choice
answers be listed vertically, then specify in a question section that the
answers to that question be listed horizontally. Similarly, you might define
variable values to be used throughout the exam, but override them with a new
definition for a particular question.

For the record, the following are global and not overridden: Title, CstFile,
Seed, Question Space, Question Permute, and Question Number.

\subsection{Starting a front section\textbf{\label{Starting a front section}}
}

The front section of a source file begins with a heading containing one of
these keywords:\ \textsf{Exam, Test, Tutorial, Quiz, }or \textsf{%
Assignment.\ \ }The Exam Builder treats these five keywords identically.
Although the program doesn't distinguish between these keywords, you may
find them convenient to use as you organize files containing different types
of course materials.

\subparagraph{\noindent $\blacktriangleright $\quad \textbf{To start a front
section}}

\begin{enumerate}
\item  Move the insertion point to the top of your file.

\item  From the Section/Body Tag popup list on the Tag toolbar, choose a
heading tag. You can also \hyperref{apply the tag}{}{}{Apply.tex} using the
associated function key or using the Apply command on the Tag menu.

\item  Type one of these keywords: \textsf{Exam, Test, Tutorial, Quiz,}\emph{%
\ }or \textsf{Assignment.}
\end{enumerate}

\subsection{Adding\textbf{\ comments\label{Adding comments}}}

Maintaining documentation or notes about an exam you create is often useful,
but you may not want the information to appear on the exam itself. Use
Comments sections to include this documentation in the source file but
exclude it from the generated exam.

\subparagraph{\noindent $\blacktriangleright $\quad \textbf{To add a
Comments section}}

\begin{enumerate}
\item  Press Enter to start a new paragraph and apply a heading tag.

\item  Type the keyword \textsf{Comment }and press Enter.

\item  Type the text of your comment.

The comment won't appear in the generated exam.\medskip 
\end{enumerate}

\subsection{\textbf{Adding text\label{Adding text}}}

Text placed in the front section of a source file can specify a title for
the exam, a place for the student's name, instructions for the student, and
anything else you want to appear at the top of the exam. Any text you place
in the front section will be included verbatim at the top of every exam
generated from the source file.

\subparagraph{\noindent $\blacktriangleright $\quad \textbf{To add a Text
section}}

\begin{enumerate}
\item  Press Enter to start a new paragraph and apply a heading tag.

\item  Type the keyword \textsf{Text} and press Enter.

\item  If you want the exam to begin with a title, type the title as you
want it to appear in final form and press Enter.

\item  If you want to include an input box for the student's name, select 
\textbf{Student Name Input }from the popup list on the Fragments toolbar or,
from the File menu, choose Import Fragment, select \textbf{Student Name
Input.frg}, and then choose OK.

On your screen you see a box like this: 
%TCIMACRO{\HTML{<Input TYPE="Text" NAME="STUDENTNAME" VALUE=" " SIZE=0>}}
%BeginExpansion
%%
%EndExpansion

If you want to change the length of the box, double-click it and change the
size specification, then choose OK.

\item  If you want to include instructions for the student, press Enter to
start a new paragraph and type the instructions.

\item  Format the text information to your liking, adding any space you want
between the front section and the first question.

For more information about formatting \textit{Scientific Notebook }%
documents,\ use the \hyperref{online Help}{}{}{Contents.tex} system.
\end{enumerate}

\noindent \FRAME{itbpF}{0.537in}{0.2318in}{0in}{}{}{ex3.wmf}{\special%
{language "Scientific Word";type "GRAPHIC";maintain-aspect-ratio
TRUE;display "PICT";valid_file "F";width 0.537in;height 0.2318in;depth
0in;original-width 48.875pt;original-height 19.5625pt;cropleft "0";croptop
"1";cropright "1";cropbottom "0";filename 'Ex3.wmf';file-properties "XNPEU";}%
}

This Text section shown here:

\FRAME{dtbpF}{346.9375pt}{151.0625pt}{0pt}{}{}{Figure }{\special{language
"Scientific Word";type "GRAPHIC";maintain-aspect-ratio TRUE;display
"PICT";valid_file "F";width 346.9375pt;height 151.0625pt;depth
0pt;original-width 459.9375pt;original-height 198.75pt;cropleft "0";croptop
"1";cropright "1";cropbottom "0";filename 'EB7.wmf';file-properties
"XNPEUR";}}

produces this text at the top of the generated exam:

\FRAME{dtbpF}{384.25pt}{126.9375pt}{0pt}{}{}{Figure }{\special{language
"Scientific Word";type "GRAPHIC";maintain-aspect-ratio TRUE;display
"PICT";valid_file "F";width 384.25pt;height 126.9375pt;depth
0pt;original-width 380.1875pt;original-height 124.1875pt;cropleft
"0";croptop "1";cropright "1";cropbottom "0";filename
'EB5.wmf';file-properties "XNPEUR";}}\medskip

\subsection{Setting up an exam\textbf{\label{Setting up an exam}}}

In the front section you can specify general instructions for setting up the
exam. Setup instructions, many of which initiate basic algorithmic
variations for the exam as a whole, can include specifications for

\begin{itemize}
\item  the text displayed in the title bar when the exam is opened online

\item  the style used to format the exam

\item  the order in which the questions appear on the generated exam

\item  the space between questions

\item  the type and appearance of multiple-choice answers

\item  the order in which multiple-choice answers appear for each question

\item  online grading

\item  global variables and random selection of values for the questions
\end{itemize}

Remember that setup instructions entered in the front section apply to the
entire exam. You can override them for a particular question by entering
setup instructions for that question.

\subparagraph{\noindent $\blacktriangleright $\quad \textbf{To add a Setup
section\label{Adding a Setup section}}}

\begin{enumerate}
\item  Press Enter to start a new paragraph and apply a heading tag.

\item  Type the keyword \textsf{Setup} and press Enter.

Until it encounters a new section heading, the Exam Builder includes all
subsequent information in the setup section.\medskip 
\end{enumerate}

\subparagraph{\noindent $\blacktriangleright $\quad \textbf{To add text for
the title bar\label{Adding text for the title bar}}}

\begin{enumerate}
\item  Start a new paragraph in the Setup section.

\item  Type the keyword \textsf{Title:}\textbf{\ }and then type the
information you want to appear in the title bar.

Whenever the generated exam is opened online, this information appears in
the title bar of the exam window. The title bar identifies the exam, even if
the student has scrolled past the point where the title specified in the
Text section is visible.\medskip 
\end{enumerate}

\noindent \FRAME{itbpF}{42.875pt}{18.125pt}{4pt}{}{}{ex3.wmf}{\special%
{language "Scientific Word";type "GRAPHIC";maintain-aspect-ratio
TRUE;display "PICT";valid_file "F";width 42.875pt;height 18.125pt;depth
4pt;original-width 48.875pt;original-height 19.5625pt;cropleft "0";croptop
"1";cropright "1";cropbottom "0";filename 'Ex3.wmf';file-properties "XNPEU";}%
}Title: Calculus 110 Section 2 - Chapter 4 Quiz\medskip

\subparagraph{\noindent $\blacktriangleright $\quad \textbf{To }specify a
style for the exam\label{Specifying a style}}

\begin{enumerate}
\item  Start a new paragraph in the Setup section.

\item  Type the keyword \textsf{Cstfile:}\textbf{\ }and then type the name
of the style you want the Exam Builder to use when it generates the exam. To
display a list of available styles, choose Style from the File menu. The
default style used if you do not specify a Cstfile is called Blue Homework.

When the Exam Builder generates an instance of the exam, it formats the
content of the exam according to the style you specify.\medskip 
\end{enumerate}

\noindent \FRAME{itbpF}{42.875pt}{18.125pt}{4pt}{}{}{ex3.wmf}{\special%
{language "Scientific Word";type "GRAPHIC";maintain-aspect-ratio
TRUE;display "PICT";valid_file "F";width 42.875pt;height 18.125pt;depth
4pt;original-width 48.875pt;original-height 19.5625pt;cropleft "0";croptop
"1";cropright "1";cropbottom "0";filename 'Ex3.wmf';file-properties "XNPEU";}%
}Cstfile: Math.cst\medskip

\subparagraph{\noindent $\blacktriangleright $\quad \textbf{To permute the
order in which questions appear\label{Permuting the questions}}}

\begin{enumerate}
\item  Start a new paragraph in the Setup section.

\item  Type the keyword \textsf{Questions:}\textbf{\ }followed by the
keyword \textsf{Permute.}

Note that you can combine several keywords in one Questions statement.

When the Exam Builder generates the exam, it places the questions in random
order. Thus, the order of the questions on each generated exam differs
slightly.\medskip 
\end{enumerate}

\noindent \FRAME{itbpF}{42.875pt}{18.125pt}{4pt}{}{}{ex3.wmf}{\special%
{language "Scientific Word";type "GRAPHIC";maintain-aspect-ratio
TRUE;display "PICT";valid_file "F";width 42.875pt;height 18.125pt;depth
4pt;original-width 48.875pt;original-height 19.5625pt;cropleft "0";croptop
"1";cropright "1";cropbottom "0";filename 'Ex3.wmf';file-properties "XNPEU";}%
}Questions: Permute

\noindent \FRAME{itbpF}{42.875pt}{18.125pt}{4pt}{}{}{ex3.wmf}{\special%
{language "Scientific Word";type "GRAPHIC";maintain-aspect-ratio
TRUE;display "PICT";valid_file "F";width 42.875pt;height 18.125pt;depth
4pt;original-width 48.875pt;original-height 19.5625pt;cropleft "0";croptop
"1";cropright "1";cropbottom "0";filename 'Ex3.wmf';file-properties "XNPEU";}%
}Questions: No permute

The first example changes the order of the questions on each instance of the
generated exam; the second example leaves the questions in the same order
for all instances of the exam.\medskip

\subparagraph{\noindent $\blacktriangleright $\quad \textbf{To number the
questions on an exam}}

You can turn question numbers on and off.

\begin{enumerate}
\item  Start a new paragraph in the Setup section.

\item  Type the keyword \textsf{Questions:}\textbf{\ }followed by the
keyword \textsf{Number} if you want numbered questions and \textsf{No number 
}if you want unnumbered questions.

You can combine several keywords in one Questions statement.\medskip 
\end{enumerate}

\noindent \FRAME{itbpF}{42.875pt}{18.125pt}{4pt}{}{}{ex3.wmf}{\special%
{language "Scientific Word";type "GRAPHIC";maintain-aspect-ratio
TRUE;display "PICT";valid_file "F";width 42.875pt;height 18.125pt;depth
4pt;original-width 48.875pt;original-height 19.5625pt;cropleft "0";croptop
"1";cropright "1";cropbottom "0";filename 'Ex3.wmf';file-properties "XNPEU";}%
}Questions: Number

\noindent \FRAME{itbpF}{42.875pt}{18.125pt}{4pt}{}{}{ex3.wmf}{\special%
{language "Scientific Word";type "GRAPHIC";maintain-aspect-ratio
TRUE;display "PICT";valid_file "F";width 42.875pt;height 18.125pt;depth
4pt;original-width 48.875pt;original-height 19.5625pt;cropleft "0";croptop
"1";cropright "1";cropbottom "0";filename 'Ex3.wmf';file-properties "XNPEU";}%
}Questions: No number

The first example numbers the questions on the generated exam; the second
example leaves the questions unnumbered.\medskip

\subparagraph{\noindent $\blacktriangleright $\quad \textbf{To specify the
vertical space between questions\label{Spacing between questions}}}

\begin{enumerate}
\item  Start a new paragraph in the Setup section.

\item  Type the keyword \textsf{Question Space:}\textbf{\ }followed by a
spacing factor.

The spacing factor is relative. The larger the number, the greater the
space. In general, a factor between 1 and 10 results in adequate separation
between questions.

Remember that you can combine several keywords in one Questions statement.
The Exam Builder adds the space when it generates the exam. You can examine
the spacing between questions if you open and preview the .qiz file for the
generated exam. If the spacing isn't satisfactory, change the spacing
factor.\medskip 
\end{enumerate}

\noindent \FRAME{itbpF}{42.875pt}{18.125pt}{4pt}{}{}{ex3.wmf}{\special%
{language "Scientific Word";type "GRAPHIC";maintain-aspect-ratio
TRUE;display "PICT";valid_file "F";width 42.875pt;height 18.125pt;depth
4pt;original-width 0pt;original-height 0pt;cropleft "0";croptop
"1";cropright "1";cropbottom "0";filename 'Ex3.wmf';file-properties "XNPEU";}%
}Question Space: 2

\noindent \FRAME{itbpF}{42.875pt}{18.125pt}{4pt}{}{}{ex3.wmf}{\special%
{language "Scientific Word";type "GRAPHIC";maintain-aspect-ratio
TRUE;display "PICT";valid_file "F";width 42.875pt;height 18.125pt;depth
4pt;original-width 48.875pt;original-height 19.5625pt;cropleft "0";croptop
"1";cropright "1";cropbottom "0";filename 'Ex3.wmf';file-properties "XNPEU";}%
}Question Space: 5

These two spacing factors have different effects in the generated exam:

\noindent \FRAME{itbpF}{461pt}{237pt}{0pt}{}{}{Figure }{\special{language
"Scientific Word";type "GRAPHIC";maintain-aspect-ratio TRUE;display
"PICT";valid_file "F";width 461pt;height 237pt;depth 0pt;original-width
655.6875pt;original-height 335.75pt;cropleft "0";croptop "1";cropright
"1";cropbottom "0";filename 'EB2.wmf';file-properties "XNPEUR";}} \medskip

\subparagraph{\noindent $\blacktriangleright $\quad \textbf{To set up
multiple-choice answers\label{Setting up multiple-choice answers}}}

In the Setup section of your exam, you can set specifications for the
answers you present in multiple-choice lists. The Exam Builder will apply
these specifications to any multiple-choice lists that occur in the exam,
unless you override them with answer specifications for a particular
question. Chapter 5 contains information about setting up the lists
themselves.

\begin{enumerate}
\item  Start a new paragraph in the Setup section.

\item  Type the keyword \textsf{Choices:}\textbf{\ }followed by the keywords
you need, separated by commas.

\item  Specify the type of multiple-choice answers you want with one of
these keywords:

\begin{tabular}{ll}
\textbf{Keyword} & \textbf{Effect} \\ 
\textsf{Radio Buttons} & Inserts a clickable button next to each choice in
the answer list \\ 
\textsf{Check} & Inserts a checkbox next to each choice in the answer list
\end{tabular}

If you specify Radio Buttons, the student can select only one answer from
the list. If you specify Check, the student can select multiple answers from
the list.

\item  Specify the layout of the answers with one of these keywords:

\begin{tabular}{ll}
\textbf{Choice} & \textbf{Effect} \\ 
\textsf{Break} & Displays the multiple-choice list vertically \\ 
\textsf{No Break} & Displays the multiple-choice list horizontally
\end{tabular}

\item  If you want to specify the horizontal spacing between multiple-choice
items, press Enter to start a new paragraph.

\item  Type the keyword \textsf{Choice Space: }followed by a spacing factor.

The spacing factor is relative. The larger the number, the greater the
space. In general, a factor between 2 and 10 results in adequate separation
between list items.\medskip 
\end{enumerate}

\noindent \FRAME{itbpF}{42.875pt}{18.125pt}{4pt}{}{}{ex3.wmf}{\special%
{language "Scientific Word";type "GRAPHIC";maintain-aspect-ratio
TRUE;display "PICT";valid_file "F";width 42.875pt;height 18.125pt;depth
4pt;original-width 48.875pt;original-height 19.5625pt;cropleft "0";croptop
"1";cropright "1";cropbottom "0";filename 'Ex3.wmf';file-properties "XNPEU";}%
}

Choices: Radio Buttons, No Break

Choice Space: 5

These two lines result in a multiple-choice list that looks like this in the
generated exam:

\FRAME{dtbpF}{298.5pt}{47.75pt}{0pt}{}{}{Figure }{\special{language
"Scientific Word";type "GRAPHIC";maintain-aspect-ratio TRUE;display
"FULL";valid_file "F";width 298.5pt;height 47.75pt;depth 0pt;original-width
395.25pt;original-height 61pt;cropleft "0";croptop "1";cropright
"1";cropbottom "0";filename 'EB3.wmf';file-properties "XNPEUR";}}

\subparagraph{\noindent $\blacktriangleright $\quad \textbf{To permute the
order of items in multiple-choice lists\label%
{Permuting multiple-choice answers}}}

You can change the order of multiple-choice answers if the answers are items
in a bulleted list. Chapter 5 explains how to create multiple-choice lists.

\begin{enumerate}
\item  Place the insertion point at the end of the Choices: paragraph.

\item  Type a comma and then type the keyword \textsf{Permute.}

When the Exam Builder generates the exam, it places the answers to each
multiple-choice question in random order. Thus, the order of the answers for
each multiple-choice question differs slightly on each generated
exam.\medskip 
\end{enumerate}

\noindent \FRAME{itbpF}{42.875pt}{18.125pt}{4pt}{}{}{ex3.wmf}{\special%
{language "Scientific Word";type "GRAPHIC";maintain-aspect-ratio
TRUE;display "PICT";valid_file "F";width 42.875pt;height 18.125pt;depth
4pt;original-width 48.875pt;original-height 19.5625pt;cropleft "0";croptop
"1";cropright "1";cropbottom "0";filename 'Ex3.wmf';file-properties "XNPEU";}%
}Choices: Radio Buttons, Permute

This line changes the order of the items in the multiple-choice list each
time a new instance of the exam is generated.\medskip

\subparagraph{\noindent $\blacktriangleright $\quad \textbf{To submit exams
for online grading\label{Submitting exams}}}

If the exam will be graded online, you can insert a button for students to
click when they are ready to submit their answers to the grading program.

\begin{enumerate}
\item  Start a new paragraph in the Setup section.

\item  Type the keyword \textsf{Submit: }followed by the text you want to
appear on the button.\textsf{.}

When the Exam Builder generates the exam, it places the button at the end of
the exam. The student clicks the button to submit his or her answers for
immediate grading and feedback.
\end{enumerate}

\noindent \FRAME{itbpF}{42.875pt}{18.125pt}{4pt}{}{}{ex3.wmf}{\special%
{language "Scientific Word";type "GRAPHIC";maintain-aspect-ratio
TRUE;display "PICT";valid_file "F";width 42.875pt;height 18.125pt;depth
4pt;original-width 48.875pt;original-height 19.5625pt;cropleft "0";croptop
"1";cropright "1";cropbottom "0";filename 'Ex3.wmf';file-properties "XNPEU";}%
}Submit: Grade the exam

This line places the text ``Grade the exam'' in a button at the end of the
exam.

\noindent \FRAME{itbpF}{42.875pt}{18.125pt}{4pt}{}{}{ex3.wmf}{\special%
{language "Scientific Word";type "GRAPHIC";maintain-aspect-ratio
TRUE;display "PICT";valid_file "F";width 42.875pt;height 18.125pt;depth
4pt;original-width 48.875pt;original-height 19.5625pt;cropleft "0";croptop
"1";cropright "1";cropbottom "0";filename 'Ex3.wmf';file-properties "XNPEU";}%
}

The front section shown below is part of an exam for an Algebra 1 class. It
presents instructions for the students and specifies that the exam will
contain multiple-choice questions. The answers to those questions will be
presented in a vertical list and their order will not change from instance
to instance. The exam will not be delivered online, so no title bar
information in included. The section also includes a comment that doesn't
appear in the generated exam.

\FRAME{dtbpF}{362.3125pt}{423.5625pt}{0pt}{}{}{Figure }{\special{language
"Scientific Word";type "GRAPHIC";maintain-aspect-ratio TRUE;display
"FULL";valid_file "F";width 362.3125pt;height 423.5625pt;depth
0pt;original-width 0pt;original-height 0pt;cropleft "0";croptop
"1";cropright "1";cropbottom "0";filename 'EB30.wmf';file-properties
"NPEUR";}}

This is what the student sees:

\FRAME{dtbpF}{360.8125pt}{185.1875pt}{0pt}{}{}{Figure }{\special{language
"Scientific Word";type "GRAPHIC";maintain-aspect-ratio TRUE;display
"FULL";valid_file "F";width 360.8125pt;height 185.1875pt;depth
0pt;original-width 0pt;original-height 0pt;cropleft "0";croptop
"1";cropright "1";cropbottom "0";filename 'EB31.wmf';file-properties
"NPEUR";}}

\noindent .

\end{document}
