doc/tutorial/tutorial.lyx - diff

Return to tutorial.lyx CVS log

Up to [LON-CAPA] / doc / tutorial

Diff for /doc/tutorial/Attic/tutorial.lyx between versions 1.3 and 1.8

version 1.3, 2002/06/03 05:15:59	version 1.8, 2002/07/05 16:12:31
Line 1	Line 1
#LyX 1.1 created this file. For more info see http://www.lyx.org/	#LyX 1.2 created this file. For more info see http://www.lyx.org/
\lyxformat 218	\lyxformat 220
\textclass article	\textclass article
\begin_preamble	\begin_preamble
\usepackage{floatflt}	\usepackage{floatflt}
Line 14	Line 14
\paperpackage a4	\paperpackage a4
\use_geometry 1	\use_geometry 1
\use_amsmath 0	\use_amsmath 0
	\use_natbib 0
	\use_numerical_citations 0
\paperorientation portrait	\paperorientation portrait
\leftmargin 1in	\leftmargin 1in
\topmargin 1.25in	\topmargin 1.25in
Line 27	Line 29
\quotes_times 2	\quotes_times 2
\papercolumns 1	\papercolumns 1
\papersides 1	\papersides 1
\paperpagestyle fancy	\paperpagestyle headings

\layout Title	\layout Title

Line 51 Author's Tutorial And Manual	Line 53 Author's Tutorial And Manual

\layout Standard	\layout Standard
\align center	\align center
This manual was developed by John Williamson in the Office of Medical Education	John Williamson, Felicia Berryman, Jeremy Bowers
Research and Development.
Some information in thie manual is adapted from the
\begin_inset Quotes eld
\end_inset

LON-CAPA Workshop Demo
\begin_inset Quotes erd
\end_inset

developed by Felicia Berryman in the Laboratory for Instructional Technology
in Education.
\layout Standard	\layout Standard

\SpecialChar ~	\SpecialChar ~
Line 91 Michigan State University	Line 82 Michigan State University
Introduction to LON-CAPA	Introduction to LON-CAPA
\layout Comment	\layout Comment

This is a comment which will not show in any other rendering of this document.	This is a comment that will not show in any other rendering of this document.
I will use them to document my observations as I work through this tutorial.	I will use them to document my observations as I work through this tutorial.
\layout Comment	\layout Comment

Line 110 IMHO	Line 101 IMHO
\layout Standard	\layout Standard

LON-CAPA is a web-based interface that helps to organize and present your	LON-CAPA is a web-based interface that helps to organize and present your
course website, deliver and manage problem problems, and manage student	course website, deliver and manage problems, and manage student enrollment.
enrollment.	All author functions are done through a web browser (Netscape 4.x or higher,
All author functions are done using a web browser (Netscape 4.x or higher	a recent Mozilla, or IE 5+ required).
is recommended) and the LON-CAPA Author Interface.
The URL for LON-CAPA is
\family typewriter
http://s10.lite.msu.edu
\family default
.
\layout Standard	\layout Standard

At this time, you should have:	At this time, you should have:
Line 128 developed your objectives for your cours	Line 113 developed your objectives for your cours

\layout Itemize	\layout Itemize

developed your problems for testing and identified the question formats.	developed your problems for input into LON-CAPA and determined the appropriate
	question formats.
\layout Subsection	\layout Subsection

About This Manual	About This Manual
Line 140 Throughout this manual, keywords and phr	Line 126 Throughout this manual, keywords and phr
bold type	bold type
\series default	\series default
.	.
	Function names and scripts will be shown in a
	\family typewriter
	typewriter font
	\family default
	.
\layout Standard	\layout Standard

Chapters	Much of this document can be used as a tutorial that will introduce you
	to the authoring system.
	In particular, chapters
\begin_inset LatexCommand \ref{Author Interface}	\begin_inset LatexCommand \ref{Author Interface}

\end_inset	\end_inset
Line 152 Chapters	Line 145 Chapters

\end_inset	\end_inset

comprise a tutorial that will introduce you to the authoring system.	comprise a basic tutorial that can get you started using LON-CAPA, even
After that, this document is a reference manual for authoring course materials.	with no previous LON-CAPA experience.
\layout Standard	\layout Standard

For more information, see the website at http://help.loncapa.org/, where you	For additional help, visit our FAQ at
can get help and information.	\family typewriter
If you cannot find an answer for your question, please email us and let	http://help.loncapa.org/
us know, so we put the solution to your problem online.	\family default
	.
\layout Section	\layout Section

The LON-CAPA Author Interface	The LON-CAPA Author Interface
Line 179 Login as Course Author	Line 173 Login as Course Author
\layout Standard	\layout Standard

To begin using LON-CAPA, you first need to log in to your account on LON-CAPA.	To begin using LON-CAPA, you first need to log in to your account on LON-CAPA.
Open your web browser and navigate to the LON-CAPA URL:	Open your web browser and navigate to your local LON-CAPA URL.
\family typewriter
http://s10.lite.msu.edu/
\family default
.
You will be presented with a log in screen as in figure	You will be presented with a log in screen as in figure
\begin_inset LatexCommand \ref{LON-CAPA Log in screen}	\begin_inset LatexCommand \ref{LON-CAPA Log in screen}

Line 191 http://s10.lite.msu.edu/	Line 181 http://s10.lite.msu.edu/

.	.

\begin_float fig	\begin_inset Float figure
	placement htbp
	wide false
	collapsed false

\layout Standard	\layout Standard
\align center	\align center

\begin_inset Figure size 297 234	\begin_inset Graphics FormatVersion 1
file login.eps	filename login.eps
width 3 50	display color
flags 11	size_type 1
	width 50page%
	rotateOrigin center
	lyxsize_type 1
	lyxwidth 297pt
	lyxheight 234pt
\end_inset	\end_inset


Line 211 flags 11	Line 209 flags 11
\end_inset	\end_inset

LON-CAPA Log in screen	LON-CAPA Log in screen
\end_float	\end_inset


\layout Standard	\layout Standard

Fill in the Username and Password boxes with your information.	Fill in the Username and Password boxes with your information.
Line 230 or.	Line 230 or.
\end_inset	\end_inset

Author Remote Control	Author Remote Control
\layout Comment

Comment on the remote controls: I'll only mention this once, but imagine
this comment exists everywhere a remote control image is used.
The whole
\begin_inset Quotes eld
\end_inset

remote control
\begin_inset Quotes erd
\end_inset

metaphor is fundamentally flawed and probably can't be salvaged.
Why is it flawed?
\layout Comment

\SpecialChar ~

\layout Comment

1.
The remote control invokes a metaphor, that of remote controls.
However, remote controls are useful in the real world, despite the overwhelming
complexity of modern remotes, for three major reasons: One, they never,
ever, ever change.
Two, they provide immense amounts of tactile feedback, allowing one to
overcome the complexity of using one by putting the knowlege into motor
memory.
(There are equivalent usability principles in usability, as well; look
up Fitt's Law, for instance.) Three, they all basically do the same thing;
pick up an unfamiliar TV control and you at least know in advance there
will be numbers for channel changing, vol up and down, chan up and down,
mute, etc.
The remotes used in this system do not have any of these properties.
Remotes are actually horrid UI, because they are very, very difficult to
learn; they make up for it by being useful and persistent.
\layout Comment

Further, remotes should do things.
This remote is like a remote that no matter what button you push, it invokes
a menu.
Most remotes have
\series bold
one
\series default
explicit
\begin_inset Quotes eld
\end_inset

menu
\begin_inset Quotes erd
\end_inset

button to invoke a menu that has all the feature that aren't worth valuable
remote control space.
\layout Comment

In fact, the metaphor is so unsuccessful that any moderately savvy internet
user will almost immediately come to conceptualize the remote as just another
list of links, albiet a clumsy and inconvenient one.
Why not give them that in the first place?
\layout Comment

\SpecialChar ~

\layout Comment

2.
Even the simplest
\begin_inset Quotes eld
\end_inset

remote
\begin_inset Quotes erd
\end_inset

I see in the tutorial has eight buttons, which nearly immediately becomes
seventeen (!) buttons, all incomprehensible, and I didn't get a chance
to count during the interview, but I saw a remote flash by (student remote?
admin remote? that wouldn't matter as much) that had at least twenty, probably
24 buttons, again, all or nearly all incomprehensible.
This is needlessly intimidating.
\layout Comment

\SpecialChar ~

\layout Comment

3.
By commiting to this
\begin_inset Quotes eld
\end_inset

remote control
\begin_inset Quotes erd
\end_inset

layout, you commit to a remote control's layout limitations, except that
an actual remote control can get away with a 6pt or smaller font, or wierd
specialized symbols, or whatnot.
I'm looking at a (real) remote control right now that manages to get
\begin_inset Quotes eld
\end_inset

channel return
\begin_inset Quotes erd
\end_inset

onto one button.
That whole phrase fits twice into the space the
\begin_inset Quotes eld
\end_inset

ROLES
\begin_inset Quotes erd
\end_inset

button takes up on my printout! So in actuality, you're commiting to something
no sane remote control designer could deal with.
\layout Comment

\SpecialChar ~

\layout Comment

4.
Requiring the user to mouse over something to see what it does is not a
solution.
Limiting yourself to an 8 by 2 array of characters to explain yourself
compounds the problem even more.
(Another over-literal extension of the remote control metaphor.) Also, as
you may have observed, the accessibility of this is nil.

\layout Comment

\SpecialChar ~

\layout Comment

The upshot is that the only upside to the remote control is a moderately
pleasing graphic; the downsides are pretty much everything, up to and including
possible illegality under accessability laws.
Unfortunately, I do not see any way to salvage any aspect of the remote
control; it's going to suck until it's replaced.
Pleasing graphics are relatively easy to come by nowadays; it should not
drive the design.
I'll admit (freely!) I'm not a graphics designer...
graphics designers aren't web developers (designers), either.
\layout Comment

\SpecialChar ~

\layout Comment

We're data-mining the web logs to see what people actually use.
This is good.
We may need to do some really simple stuff before he finishes.
Raw statistics on what buttons are pressed most often can probably be interpret
ed easily enough for our purposes.
No matter what the final design is, it should emphasize the two or three
commands used day in and day out, as determined by empirical analysis,
and shuffle the other commands onto another sub menu or sub menus.
Then, use the additional space you'll have (even if you keep the same size
window) and actually spell out the options.

\layout Standard	\layout Standard

The Author Remote Control, show in figure	The Author Remote Control, show in figure
Line 404 The Author Remote Control, show in figur	Line 239 The Author Remote Control, show in figur

, will automatically load whenever you log in to LON-CAPA as the course	, will automatically load whenever you log in to LON-CAPA as the course
instructor.	instructor.
The Author Remote Control is a separate window in your browser, so you	The Author Remote Control is a separate window in your browser, and is
may position it on the screen where you can make the best use of it.	automatically sized and placed in the upper left of the screen.
The Remote Control is a tool that allows you to switch between functions	The Remote Control is a tool that allows you to switch between functions
and roles within LON-CAPA.	and roles within LON-CAPA.

\begin_float fig	\begin_inset Float figure
	placement htbp
	wide false
	collapsed false

\layout Standard	\layout Standard
\align center	\align center

\begin_inset Figure size 177 420	\begin_inset Graphics FormatVersion 1
file authorRemote.eps	filename authorRemote.eps
height 3 50	display color
flags 9	size_type 1
	height 50page%
	rotateOrigin center
	lyxsize_type 1
	lyxwidth 180pt
	lyxheight 420pt
\end_inset	\end_inset


Line 429 Author Remote Control	Line 272 Author Remote Control
\end_inset	\end_inset


\end_float	\end_inset
\layout Comment

Of the eight choices on this menu, only two (ROLES and LOGOUT) make any
sort of sense on a first glance.
Abbreviations are evil in this sort of application and should be used as
a truly last resort.
\layout Standard	\layout Standard

When you move your mouse over the buttons in the remote, the sixteen gray	When you move your mouse over the buttons in the remote, the sixteen gray
Line 479 RES (RESOURCE SPACE)	Line 318 RES (RESOURCE SPACE)


\series bold	\series bold
EGRD (ENTER GRADES)	SRC (SEARCH LIBRARY)
\series default	\series default
is used to enter grades for students enrolled in your course.	brings up a screen that lets you search the LON-CAPA resources using multiple
	criteria.
\layout Itemize	\layout Itemize


\series bold	\series bold
SRC (SEARCH LIBRARY)	PREF (PREFERENCES)
\series default	\series default
brings up a screen that lets you search the LON-CAPA resources using multiple	brings up a screen that allows you to change some preferences.
criteria.
\layout Itemize	\layout Itemize


\series bold	\series bold
LOGOUT (LOGOUT)	EXIT (LOGOUT)
\series default	\series default
will log you out of the LON-CAPA system.	will log you out of the LON-CAPA system.
\layout Section	\layout Section
Line 520 Content Page	Line 359 Content Page

displays course content.	displays course content.
It is essentially a conventional HTML page.	It is essentially a conventional HTML page.
	These resources use the extension
\layout Comment	\begin_inset Quotes eld
	\end_inset

	.html
	\begin_inset Quotes erd
	\end_inset

Check this; is it exactly like HTML pages?	.
\layout Itemize	\layout Itemize

A	A
Line 550 Problem	Line 394 Problem

A	A
\series bold	\series bold
Map	Sequence
\series default	\series default

\begin_inset LatexCommand \index{Map}	\begin_inset LatexCommand \index{Sequence}

\end_inset	\end_inset

resource of the	is a type of
\series bold	\series bold
Sequence	Map
\begin_inset LatexCommand \index{Sequence}	\series default

\end_inset	\begin_inset LatexCommand \index{Map}

	\end_inset

\series default	which is used to link other resources together.
type represents a programmed series of events.	The users of this resource can use directional buttons on their remote
The users of this resource can use buttons on their remote or the NAV button	or the NAV button to follow the sequence.
to follow the sequence.	Sequences are stored in files that must use the extension
These resources are stored in files that must use the extension
\begin_inset Quotes eld	\begin_inset Quotes eld
\end_inset	\end_inset

Line 578 Sequence	Line 422 Sequence
\end_inset	\end_inset

.	.
\layout Comment	Sequences can contain other sequences and pages.

What
\begin_inset Quotes eld
\end_inset

arrow keys
\begin_inset Quotes erd
\end_inset

? Surely not the ones on the keyboard\SpecialChar \ldots{}

\layout Itemize	\layout Itemize

A	A
\series bold	\series bold
Map	Page
\series default	\series default

\begin_inset LatexCommand \index{Map}	\begin_inset LatexCommand \index{Page}

\end_inset	\end_inset

resource of the	is a type of
\series bold	\series bold
Page	Map
\series default	\begin_inset LatexCommand \index{Map}

\begin_inset LatexCommand \index{Page}

\end_inset	\end_inset

type display multiple resources together.
	\series default
	which is used to join other resources together into one HTML page.
For example, a page of problems will appears as a problem set.	For example, a page of problems will appears as a problem set.
These resources are stored in files that must use the extension	These resources are stored in files that must use the extension
\begin_inset Quotes eld	\begin_inset Quotes eld
Line 626 Page	Line 459 Page
Description of the Construction Space	Description of the Construction Space
\layout Standard	\layout Standard

\begin_float fig
	\begin_inset Float figure
	placement htbp
	wide false
	collapsed false

\layout Standard	\layout Standard
\align center	\align center

\begin_inset Figure size 476 42	\begin_inset Graphics FormatVersion 1
file constructionSpace.eps	filename constructionSpace.eps
width 3 80	display color
flags 9	size_type 1
	width 80page%
	rotateOrigin center
	lyxsize_type 1
	lyxwidth 476pt
	lyxheight 42pt
\end_inset	\end_inset


Line 646 Construction Space	Line 488 Construction Space
\end_inset	\end_inset


\end_float	\layout Standard
The Construction Space, as seen in figure
\begin_inset LatexCommand \ref{Construction Space Figure}

\end_inset

, is the section of LON-CAPA where you create and manage your course resources.	Contents of the Construction Space:
The Construction Space consists of a green tool bar at the top of the page
and a list of all directories and resources below.
\layout Standard	\layout Standard


\begin_inset Tabular	\begin_inset Tabular
<lyxtabular version="2" rows="10" columns="2">	<lyxtabular version="3" rows="10" columns="2">
<features rotate="false" islongtable="true" endhead="0" endfirsthead="0" endfoot="0" endlastfoot="0">	<features>
<column alignment="center" valignment="top" leftline="true" rightline="false" width="" special="">	<column alignment="center" valignment="top" leftline="true" width="0pt">
<column alignment="left" valignment="top" leftline="true" rightline="true" width="5in" special="">	<column alignment="left" valignment="top" leftline="true" rightline="true" width="5in">
<row topline="true" bottomline="true" newpage="false">	<row topline="true" bottomline="true">
<cell multicolumn="0" alignment="center" valignment="top" topline="true" bottomline="false" leftline="true" rightline="false" rotate="false" usebox="none" width="" special="">	<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
\begin_inset Text	\begin_inset Text

\layout Standard	\layout Standard
Line 674 The Construction Space, as seen in figur	Line 510 The Construction Space, as seen in figur
Button Name	Button Name
\end_inset	\end_inset
</cell>	</cell>
<cell multicolumn="0" alignment="left" valignment="top" topline="true" bottomline="false" leftline="true" rightline="true" rotate="false" usebox="none" width="" special="">	<cell alignment="left" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
\begin_inset Text	\begin_inset Text

\layout Standard	\layout Standard
Line 685 Description	Line 521 Description
\end_inset	\end_inset
</cell>	</cell>
</row>	</row>
<row topline="true" bottomline="false" newpage="false">	<row topline="true">
<cell multicolumn="0" alignment="center" valignment="top" topline="true" bottomline="false" leftline="true" rightline="false" rotate="false" usebox="none" width="" special="">	<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
\begin_inset Text	\begin_inset Text

\layout Standard	\layout Standard
Line 694 Description	Line 530 Description
Publish this Resource	Publish this Resource
\end_inset	\end_inset
</cell>	</cell>
<cell multicolumn="0" alignment="center" valignment="top" topline="true" bottomline="false" leftline="true" rightline="true" rotate="false" usebox="none" width="" special="">	<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
\begin_inset Text	\begin_inset Text

\layout Standard	\layout Standard
Line 703 Opens the Resource Publishing window.	Line 539 Opens the Resource Publishing window.
\end_inset	\end_inset
</cell>	</cell>
</row>	</row>
<row topline="true" bottomline="false" newpage="false">	<row topline="true">
<cell multicolumn="0" alignment="center" valignment="top" topline="true" bottomline="false" leftline="true" rightline="false" rotate="false" usebox="none" width="" special="">	<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
\begin_inset Text	\begin_inset Text

\layout Standard	\layout Standard
Line 712 Opens the Resource Publishing window.	Line 548 Opens the Resource Publishing window.
List Directory	List Directory
\end_inset	\end_inset
</cell>	</cell>
<cell multicolumn="0" alignment="center" valignment="top" topline="true" bottomline="false" leftline="true" rightline="true" rotate="false" usebox="none" width="" special="">	<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
\begin_inset Text	\begin_inset Text

\layout Standard	\layout Standard
Line 721 Lists the contents of the current workin	Line 557 Lists the contents of the current workin
\end_inset	\end_inset
</cell>	</cell>
</row>	</row>
<row topline="true" bottomline="false" newpage="false">	<row topline="true">
<cell multicolumn="0" alignment="center" valignment="top" topline="true" bottomline="false" leftline="true" rightline="false" rotate="false" usebox="none" width="" special="">	<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
\begin_inset Text	\begin_inset Text

\layout Standard	\layout Standard
Line 730 Lists the contents of the current workin	Line 566 Lists the contents of the current workin
Copy	Copy
\end_inset	\end_inset
</cell>	</cell>
<cell multicolumn="0" alignment="center" valignment="top" topline="true" bottomline="false" leftline="true" rightline="true" rotate="false" usebox="none" width="" special="">	<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
\begin_inset Text	\begin_inset Text

\layout Standard	\layout Standard
Line 739 Type a new name in the entry box to make	Line 575 Type a new name in the entry box to make
\end_inset	\end_inset
</cell>	</cell>
</row>	</row>
<row topline="true" bottomline="false" newpage="false">	<row topline="true">
<cell multicolumn="0" alignment="center" valignment="top" topline="true" bottomline="false" leftline="true" rightline="false" rotate="false" usebox="none" width="" special="">	<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
\begin_inset Text	\begin_inset Text

\layout Standard	\layout Standard
Line 748 Type a new name in the entry box to make	Line 584 Type a new name in the entry box to make
Browse	Browse
\end_inset	\end_inset
</cell>	</cell>
<cell multicolumn="0" alignment="center" valignment="top" topline="true" bottomline="false" leftline="true" rightline="true" rotate="false" usebox="none" width="" special="">	<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
\begin_inset Text	\begin_inset Text

\layout Standard	\layout Standard
Line 757 Helps you select a file to upload	Line 593 Helps you select a file to upload
\end_inset	\end_inset
</cell>	</cell>
</row>	</row>
<row topline="true" bottomline="false" newpage="false">	<row topline="true">
<cell multicolumn="0" alignment="center" valignment="top" topline="true" bottomline="false" leftline="true" rightline="false" rotate="false" usebox="none" width="" special="">	<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
\begin_inset Text	\begin_inset Text

\layout Standard	\layout Standard
Line 766 Helps you select a file to upload	Line 602 Helps you select a file to upload
Upload File	Upload File
\end_inset	\end_inset
</cell>	</cell>
<cell multicolumn="0" alignment="center" valignment="top" topline="true" bottomline="false" leftline="true" rightline="true" rotate="false" usebox="none" width="" special="">	<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
\begin_inset Text	\begin_inset Text

\layout Standard	\layout Standard
Line 775 Uploads the selected file to your Constr	Line 611 Uploads the selected file to your Constr
\end_inset	\end_inset
</cell>	</cell>
</row>	</row>
<row topline="true" bottomline="false" newpage="false">	<row topline="true">
<cell multicolumn="0" alignment="center" valignment="top" topline="true" bottomline="false" leftline="true" rightline="false" rotate="false" usebox="none" width="" special="">	<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
\begin_inset Text	\begin_inset Text

\layout Standard	\layout Standard
Line 784 Uploads the selected file to your Constr	Line 620 Uploads the selected file to your Constr
Retrieve Old Version	Retrieve Old Version
\end_inset	\end_inset
</cell>	</cell>
<cell multicolumn="0" alignment="center" valignment="top" topline="true" bottomline="false" leftline="true" rightline="true" rotate="false" usebox="none" width="" special="">	<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
\begin_inset Text	\begin_inset Text

\layout Standard	\layout Standard
Line 793 Load an older version of a resource if y	Line 629 Load an older version of a resource if y
\end_inset	\end_inset
</cell>	</cell>
</row>	</row>
<row topline="true" bottomline="false" newpage="false">	<row topline="true">
<cell multicolumn="0" alignment="center" valignment="top" topline="true" bottomline="false" leftline="true" rightline="false" rotate="false" usebox="none" width="" special="">	<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
\begin_inset Text	\begin_inset Text

\layout Standard	\layout Standard
Line 802 Load an older version of a resource if y	Line 638 Load an older version of a resource if y
Delete	Delete
\end_inset	\end_inset
</cell>	</cell>
<cell multicolumn="0" alignment="center" valignment="top" topline="true" bottomline="false" leftline="true" rightline="true" rotate="false" usebox="none" width="" special="">	<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
\begin_inset Text	\begin_inset Text

\layout Standard	\layout Standard
Line 811 Deletes the current resource	Line 647 Deletes the current resource
\end_inset	\end_inset
</cell>	</cell>
</row>	</row>
<row topline="true" bottomline="false" newpage="false">	<row topline="true">
<cell multicolumn="0" alignment="center" valignment="top" topline="true" bottomline="false" leftline="true" rightline="false" rotate="false" usebox="none" width="" special="">	<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
\begin_inset Text	\begin_inset Text

\layout Standard	\layout Standard
Line 820 Deletes the current resource	Line 656 Deletes the current resource
Rename	Rename
\end_inset	\end_inset
</cell>	</cell>
<cell multicolumn="0" alignment="center" valignment="top" topline="true" bottomline="false" leftline="true" rightline="true" rotate="false" usebox="none" width="" special="">	<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
\begin_inset Text	\begin_inset Text

\layout Standard	\layout Standard
Line 829 Type a new name in the associated entry	Line 665 Type a new name in the associated entry
\end_inset	\end_inset
</cell>	</cell>
</row>	</row>
<row topline="true" bottomline="true" newpage="false">	<row topline="true" bottomline="true">
<cell multicolumn="0" alignment="center" valignment="top" topline="true" bottomline="false" leftline="true" rightline="false" rotate="false" usebox="none" width="" special="">	<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
\begin_inset Text	\begin_inset Text

\layout Standard	\layout Standard
Line 838 Type a new name in the associated entry	Line 674 Type a new name in the associated entry
New Subdirectory	New Subdirectory
\end_inset	\end_inset
</cell>	</cell>
<cell multicolumn="0" alignment="center" valignment="top" topline="true" bottomline="false" leftline="true" rightline="true" rotate="false" usebox="none" width="" special="">	<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
\begin_inset Text	\begin_inset Text

\layout Standard	\layout Standard
Line 852 Type a name in the entry box to create a	Line 688 Type a name in the entry box to create a
\end_inset	\end_inset


	\end_inset

	The Construction Space, as seen in figure
	\begin_inset LatexCommand \ref{Construction Space Figure}

	\end_inset

	, is the section of LON-CAPA where you create and manage your course resources.
	The figure explains what each button does.
\layout Subsection	\layout Subsection

How to Create New Content Pages	How to Create New Content Pages
Line 867 How to Create New Content Pages	Line 712 How to Create New Content Pages
Content Pages	Content Pages
\series default	\series default
are HTML documents that display the course information you are presenting.	are HTML documents that display the course information you are presenting.
To create new Content Pages, do the following:
\layout Comment	\layout Standard

	Many users use tools such as Dreamweaver to create web pages.
	To upload HTML files generated with such tools, you can use the
	\series bold
	Browse
	\series default
	button in the Construction Space, locate your HTML file, and use the
	\series bold
	Upload File
	\series default
	button to create a content page in LON-CAPA.
	Remember to upload any graphics your generated web pages may have included.
	\layout Standard

Is step one necessary? I don't see how it could be.	To create new Content Pages, do the following:
\layout Enumerate	\layout Enumerate

Click the	Click the
Line 878 Click the	Line 736 Click the
CSTR	CSTR
\series default	\series default
button on the LON-CAPA remote.	button on the LON-CAPA remote.
You web page will change to your Construction Space.	Your web page will change to your Construction Space.
\layout Enumerate	\layout Enumerate

In Location bar of your browser, type in full URL of the new Content Page.	In the Location bar of your browser, type in the full URL of the new Content
	Page.
Make sure the last part of the URL ends with	Make sure the last part of the URL ends with
\begin_inset Quotes eld	\begin_inset Quotes eld
\end_inset	\end_inset
Line 891 In Location bar of your browser, type in	Line 750 In Location bar of your browser, type in
\end_inset	\end_inset

, for example,	, for example,
	\newline

\emph on	\emph on
http://www.s10.lite.msu.edu/priv/\SpecialChar \-	http://www.s10.lite.msu.edu/priv/username/new_resource.html
directory/new_resource.html
\emph default	\emph default
.	.
Press the Return or Enter key.	\newline
\layout Enumerate	Press the Return or Enter key.

You should see something like the following message:
\series bold
File not found: /home/wmsonj/priv/\SpecialChar \-
directory/new_resource.html
\series default
, and an Edit button.
Click the
\begin_inset Quotes eld
\end_inset

Edit
\begin_inset Quotes erd
\end_inset

button, and an HTML editor will open with a simple page template.
\layout Enumerate	\layout Enumerate

Type the content into the editor,	Type the content into the editor,
\emph on	\emph on
OR	OR
\emph default	\emph default
copy and paste HTML source code into the editor.	copy and paste HTML source code obtained through the use of some other
	HTML authoring program into the editor.
\layout Enumerate	\layout Enumerate

Optionally, click the	Optionally, click the
Line 951 Repeat this process as many times as nec	Line 796 Repeat this process as many times as nec

If you're following this as a tutorial, create at least one content page,	If you're following this as a tutorial, create at least one content page,
which we'll use later as raw material.	which we'll use later as raw material.
	\begin_inset Foot
	collapsed true

	\layout Standard

	Visit the FAQ at
	\family typewriter
	http://help.lon-capa.org/
	\family default
	if you get
	\begin_inset Quotes eld
	\end_inset

	unmatched tag
	\begin_inset Quotes erd
	\end_inset

	warnings.
	\end_inset


\layout Subsection	\layout Subsection

How to Edit Existing Content Pages	How to Edit Existing Content Pages
\layout Standard	\layout Standard

You may edit any any Content Pages that have been created.	You may edit any Content Pages that have been created.
\layout Standard	\layout Standard

To edit Content Pages:	To edit Content Pages:
Line 975 Click on the link for the name of the Co	Line 841 Click on the link for the name of the Co
Content Page.	Content Page.
\layout Enumerate	\layout Enumerate

Press the Edit button.	Press the
Edit the HTML code, or copy and paste HTML source code into the editor.
\layout Enumerate

Optionally, click the
\series bold	\series bold
View	Edit
\series default	\series default
button to preview your Content Page.	button.
	Edit the HTML code, or copy and paste HTML source code into the editor.
\layout Enumerate	\layout Enumerate

Finally, click the	Finally, click the
Line 1000 Save and then attempt to clean HTML	Line 863 Save and then attempt to clean HTML
\series default	\series default
button.	button.
If you do not do this, your work will not be saved.	If you do not do this, your work will not be saved.
	\layout Standard

	Once you've saved your page, you can click the
	\series bold
	View
	\series default
	button to preview your Content Page.
\layout Subsection	\layout Subsection

Creating Online Problems Using LON-CAPA	Creating Online Problems Using LON-CAPA
Line 1008 Creating Online Problems Using LON-CAPA	Line 878 Creating Online Problems Using LON-CAPA
If you're following this as a tutorial, go ahead and make one of each of	If you're following this as a tutorial, go ahead and make one of each of
these problem types now.	these problem types now.
We'll be using them later as raw material to assemble maps and sequences.	We'll be using them later as raw material to assemble maps and sequences.
	\layout Standard

	While several problem types are listed here, in LON-CAPA, all problems are
	actually the same.
	All problems are written in XML, which can be obtained and edited with
	the
	\series bold
	EditXML
	\series default
	button you'll see.
	The problem types listed in this manual are actually just templates.
	As your knowledge advances, you may wish to play with the XML representation
	directly to see what you can do.
\layout Subsubsection	\layout Subsubsection

Problems Types	Problems Types
\layout Standard	\layout Standard

There are five types of problems that can be created with the LON-CAPA system:	In this manual we will cover five basic types of problems: Radio Response,
Radio Response, Option Response, String Response, Numerical Response, and	Option Response, String Response, Numerical Response, and Formula Response.
Formula Response.
You will need to identify which types of problem you want to use and create	You will need to identify which types of problem you want to use and create
appropriate questions for your course.	appropriate questions for your course.
	\layout Standard

	The problem editor gives you a testing area where you can try your problems
	out, with several different randomizations by varying the
	\series bold
	Random Seed
	\series default
	.
	If you answer a problem correctly and can no longer enter new answers,
	you can get the answer field back by hitting the
	\series bold
	Reset Submissions
	\begin_inset LatexCommand \index{Reset Submissions}

	\end_inset


	\series default
	button.
\layout Subsubsection	\layout Subsubsection

Foils	Foils
Line 1032 Foil	Line 933 Foil


\series default	\series default
is a choice in a Radio Response or Option Response problem.	is the statement after the drop-down box or radio button in a Radio Response
For instance, True/False problems have two foils, one for True, and one	or Option Response problem.
for False.
Foils do not need to be text; they can be images or other resources.	Foils do not need to be text; they can be images or other resources.
\layout Subsubsection	\layout Subsubsection

Line 1050 Radio Response	Line 950 Radio Response
\series bold	\series bold
Radio Response	Radio Response
\series default	\series default
problems represent multiple choice questions.	problems present a list of foils, with buttons in front.
A True/False problem is a special case of Radio Response problem with two	The student can select
foils, True or False.	\emph on
\layout Standard	one
	\emph default
Multiple choice problems contain between 3 and 10 foils.	of these statements by clicking the appropriate radio button.
You may display from three to five foils for each problem and the system
randomly picks the choices that are presented to the student.
\layout Comment

Eh? If this means what I think it means, clarify.
Is the system really incapable of showing eight choices all at once?
\layout Subsubsection	\layout Subsubsection

Option Response	Option Response
Line 1072 Option Response	Line 966 Option Response
Problems	Problems
\layout Standard	\layout Standard

Option Response problems present foils to the student with drop-down boxes.
A group of foils is created for each concept group, and the system will	\series bold
pick one to present to the student from each group.	Option Response
The student must match each of his or her questions correctly to the possible	\series default
answers before receiving credit for the problem.	problems present foils to the student with drop-down boxes.
For more details, see the Create Option Response (	The student can select the matching choice for the foils from a list of
	choices.
	Optionally, the foils may be bundled into Concept Groups, and the system
	will select one foil from each displayed group to display to the student.
	For more details, see Create Option Response in section
\begin_inset LatexCommand \ref{Create Option Response Problem}	\begin_inset LatexCommand \ref{Create Option Response Problem}

\end_inset	\end_inset

).	.
\layout Subsubsection	\layout Subsubsection

String Response Problems	String Response Problems
Line 1137 Samuel Clements	Line 1035 Samuel Clements
\begin_inset Quotes erd	\begin_inset Quotes erd
\end_inset	\end_inset

, then the student will definately get it wrong.	, then the student will definitely get it wrong.
There is some room for flexibility in the string processing, but it can	There is some room for flexibility in the string processing, but it can
be difficult to get it all right.	be difficult to get it all right.
Before you use a String Response problem, be sure you can easily characterize	Before you use a String Response problem, be sure you can easily characterize
Line 1158 Numerical Response	Line 1056 Numerical Response
\series default	\series default
problems are answered by entering a number and (optionally) a unit, such	problems are answered by entering a number and (optionally) a unit, such
as 2.5 m/s^2.	as 2.5 m/s^2.
Tolerance and significant digits can be specified as well.	Tolerance and required significant digits can be specified as well.
\layout Subsubsection	\layout Subsubsection

Formula Response Problems	Formula Response Problems
\layout Standard	\layout Standard

Formula Response problems are questions in which the student types in a
math formula for the answer.	\series bold
	Formula Response
	\series default
	problems ask the student to type in a math formula for the answer.
If the answer is	If the answer is
\begin_inset Formula $ x^{2}-11 $	\begin_inset Formula $x^{2}-11$
\end_inset	\end_inset

, the student can enter "x^2 - 11", "x*x - 11", "x^2 + 21 - 10", etc.	, the student can enter "x^2 - 11", "x*x - 11", "x^2 + 21 - 10", etc.
Line 1178 Formula Response problems are questions	Line 1079 Formula Response problems are questions
Creating Radio Response Problems	Creating Radio Response Problems
\layout Standard	\layout Standard

\begin_float fig
	\begin_inset Float figure
	placement htbp
	wide false
	collapsed false

\layout Standard	\layout Standard
\align center	\align center

\begin_inset Figure size 476 201	\begin_inset Graphics FormatVersion 1
file creatingNewProblemResource.eps	filename creatingNewProblemResource.eps
width 3 80	display color
flags 13	size_type 1
	width 80page%
	rotateOrigin center
	lyxsize_type 1
	lyxwidth 476pt
	lyxheight 202pt
\end_inset	\end_inset


Line 1198 Creating A New Problem Resource	Line 1108 Creating A New Problem Resource
\end_inset	\end_inset


\end_float	\end_inset
To create an Radio Response
	To create a Radio Response
\begin_inset LatexCommand \index{Radio Response}	\begin_inset LatexCommand \index{Radio Response}

\end_inset	\end_inset
Line 1233 problem	Line 1144 problem
\end_inset	\end_inset

.	.
\begin_float fig	\begin_inset Float figure
	placement htbp
	wide false
	collapsed false

\layout Standard	\layout Standard
\align center	\align center

\begin_inset Figure size 476 283	\begin_inset Graphics FormatVersion 1
file radioResponse2.eps	filename radioResponse2.eps
width 3 80	display color
flags 9	size_type 1
	width 80page%
	rotateOrigin center
	lyxsize_type 1
	lyxwidth 476pt
	lyxheight 283pt
\end_inset	\end_inset


Line 1253 Radio Response Creation Form	Line 1172 Radio Response Creation Form
\end_inset	\end_inset


\end_float	\end_inset
You will need to create the posible answers and the questions.
	You will need to specify the question text and foil statements.
\layout Enumerate	\layout Enumerate

In the drop-down option box as seen in	In the drop-down option box as seen in figure
\begin_inset LatexCommand \ref{Creating a new problem resource}	\begin_inset LatexCommand \ref{Creating a new problem resource}

\end_inset	\end_inset
Line 1278 Click the	Line 1198 Click the
Edit	Edit
\series default	\series default
button above the sample problem to enter edit mode.	button above the sample problem to enter edit mode.
	You should see an editing screen like figure
	\begin_inset LatexCommand \ref{Radio Response Creation Form}

	\end_inset

	.
\layout Enumerate	\layout Enumerate

In the	In the
Line 1306 Response: One of N statements	Line 1232 Response: One of N statements
\series bold	\series bold
Max Number of Shown Foils	Max Number of Shown Foils
\series default	\series default
text box, place the number of wrong answers you wish to supply to each	text box, place the number of foils you wish to display to the student.
student, in addition to the correct one.
For instance, if you want to display four choices, where one is correct
and three are incorrect, enter
\begin_inset Quotes eld
\end_inset

3
\begin_inset Quotes erd
\end_inset

into this box.
\layout Enumerate	\layout Enumerate

Locate	Locate
Line 1342 Four.	Line 1257 Four.
\begin_inset Quotes erd	\begin_inset Quotes erd
\end_inset	\end_inset

	Make sure this is set to
	\series bold
	true
	\series default
	in the
	\series bold
	Correct Option
	\series default
	field.
\layout Enumerate	\layout Enumerate

Below it, you will see	Below it, you will see
Line 1363 Purple.	Line 1286 Purple.
\begin_inset Quotes erd	\begin_inset Quotes erd
\end_inset	\end_inset

	Make sure this is set to
	\series bold
	false
	\series default
	in the
	\series bold
	Correct Option
	\series default
	field.
\layout Enumerate	\layout Enumerate

Repeat the previous step until you've filled in all of the other incorrect	Repeat the previous step until you've filled in all of the other incorrect
Line 1381 Unused	Line 1312 Unused
.	.
\layout Enumerate	\layout Enumerate

\begin_float fig
	\begin_inset Float figure
	placement htbp
	wide false
	collapsed false

\layout Standard	\layout Standard
\align center	\align center

\begin_inset Figure size 476 92	\begin_inset Graphics FormatVersion 1
file radioResponseHint.eps	filename radioResponseHint.eps
width 3 80	display color
flags 9	size_type 1
	width 80page%
	rotateOrigin center
	lyxsize_type 1
	lyxwidth 476pt
	lyxheight 92pt
\end_inset	\end_inset


Line 1401 Hint Element	Line 1341 Hint Element
\end_inset	\end_inset


\end_float	\end_inset

Scroll down to the Hint element, as shown in Figure	Scroll down to the Hint element, as shown in Figure
\begin_inset LatexCommand \ref{Radio Response Hint Element Figure}	\begin_inset LatexCommand \ref{Radio Response Hint Element Figure}

Line 1409 Scroll down to the Hint element, as show	Line 1350 Scroll down to the Hint element, as show

.	.
Type some text that will help students when they answer incorrectly.	Type some text that will help students when they answer incorrectly.
	You may delete the hint by selecting
	\series bold
	Yes
	\series default
	from the
	\series bold
	Delete
	\series default
	drop-down box.
\layout Enumerate	\layout Enumerate

Click the	Click the
Line 1434 true	Line 1384 true
\series bold	\series bold
true	true
\series default	\series default
, so you can have questions with multiple correct answers.	, but only one will be shown to any given student.
If it is set to	If it is set to
\series bold	\series bold
false	false
Line 1464 Maximum Number of Shown Foils	Line 1414 Maximum Number of Shown Foils
box contains the number of incorrect answers, which will force them to	box contains the number of incorrect answers, which will force them to
all be displayed.	all be displayed.
If you wish to force the system to display the foils in the order you have	If you wish to force the system to display the foils in the order you have
created them in, type the HTML tag	created them in, type the tag
\series bold	\series bold
<norandom>	<norandom />
\series default	\series default
into your problem text.	into your problem text.
This can be useful with the ever-popular	This can be useful with the ever-popular
Line 1479 All of the above	Line 1429 All of the above

choice, which must be displayed in the correct place or its meaning will	choice, which must be displayed in the correct place or its meaning will
change.	change.
\layout Subsubsection

True/False
\begin_inset LatexCommand \index{True/False Problem}

\end_inset

Problem
\layout Standard

A True/False problem is a Radio Response problem with two choices, True
and False.
set the
\series bold
Maximum Number of Shown Foils
\series default
to
\begin_inset Quotes eld
\end_inset

1
\begin_inset Quotes erd
\end_inset

, and mark the correct answer
\series bold
true
\series default
.
For example, for the True/False question
\begin_inset Quotes eld
\end_inset

Napolean conquered Japan in the year 189 A.D.
\begin_inset Quotes erd
\end_inset

, mark the foil containing the answer
\begin_inset Quotes eld
\end_inset

False
\begin_inset Quotes erd
\end_inset

as
\series bold
true
\series default
, because it is the correct answer.
\layout Subsection	\layout Subsection

Option Response	Option Response
Line 1542 Option Response	Line 1442 Option Response
\end_inset	\end_inset

Problems	Problems
	\layout Subsubsection

	Option Response problems with Concept Groups
\layout Standard	\layout Standard

\begin_float fig
	\begin_inset Float figure
	placement htbp
	wide false
	collapsed false

\layout Standard	\layout Standard
\align center	\align center

\begin_inset Figure size 476 280	\begin_inset Graphics FormatVersion 1
file optionResponseProblem.eps	filename optionResponseProblem.eps
width 3 80	display color
flags 9	size_type 1
	width 80page%
	rotateOrigin center
	lyxsize_type 1
	lyxwidth 476pt
	lyxheight 134pt
\end_inset	\end_inset


Line 1564 Option Response Problem	Line 1476 Option Response Problem
\end_inset	\end_inset


\end_float	\end_inset
Each Option Response problem has three parts:
	Each Option Response problem can have three parts:
\layout Enumerate	\layout Enumerate

The Concept Groups	The Concept Groups
Line 1604 Concept Group	Line 1517 Concept Group
\series default	\series default
has some number of foils representing questions which are conceptually	has some number of foils representing questions which are conceptually
related.	related.
Option Response Problems can have between 4 and 8 Concept Groups in a problem.	Option Response Problem Templates are available for 4 and 8 Concept Groups.
When the Option Response problem is presented to a student, the LON-CAPA	When the Option Response problem is presented to a student, the LON-CAPA
system will randomly select one foil from each Concept Group and present	system will randomly select one foil from each Concept Group and present
it to the student.	it to the student.
In order to receive credit for the problem, the student must answer all	In order to receive credit for the problem, the student must select the
of the Concept Group foils correctly.	corresponding option from the drop-down box for each given foil.
\layout Subsubsection	\layout Subsubsection

Example: Concept Group	Example: Concept Group
Line 1664 For each foil, the author marks it True	Line 1577 For each foil, the author marks it True
Example: Matching Problem	Example: Matching Problem
\layout Standard	\layout Standard

You might want to ask the student to match musical compositions with their	Option Response problems can be used as matching problems as well.
composers.	\layout Standard

	For example, you might want to ask the student to match musical compositions
	with their composers.
You could create an Option Response problem with 4 Concept Groups, and	You could create an Option Response problem with 4 Concept Groups, and
place the following four things each in their own concept group:	place the following four foil groups each in its own concept group:
\layout Itemize	\layout Itemize

Claire de Lune	Claire de Lune
Line 1675 Claire de Lune	Line 1591 Claire de Lune

\end_inset	\end_inset

	, Ballade
	\begin_inset Foot
	collapsed true

\begin_float footnote
\layout Standard	\layout Standard

Debussy.	Debussy.
\end_float	\end_inset


\layout Itemize	\layout Itemize

The Pastoral Symphony	The Pastoral Symphony, The Ninth Symphony
\begin_float footnote	\begin_inset Foot
	collapsed true

\layout Standard	\layout Standard

Beethoven's Sixth Symphony.	Beethoven.
\end_float	\end_inset


\layout Itemize	\layout Itemize

Sleeping Beauty Suite	Sleeping Beauty Suite, The Dance of the Sugar Plum Fairies
\begin_float footnote	\begin_inset Foot
	collapsed true

\layout Standard	\layout Standard

Tchaikovsky.	Tchaikovsky.
\end_float	\end_inset


\layout Itemize	\layout Itemize

The Dance of the Sugar Plum Fairies	Slavonic Dances, New World Symphony
\begin_float footnote	\begin_inset Foot
	collapsed true

\layout Standard	\layout Standard

Also Tchaikovsky, from The Nutcracker.	Dvorak.
\end_float	\end_inset


\layout Standard	\layout Standard

You could then add the following options to the option list:	You could then add the following options to the option list:
Line 1722 Schubert	Line 1654 Schubert
Tchaikovsky	Tchaikovsky
\layout Itemize	\layout Itemize

Bach	Dvorak
\layout Standard	\layout Standard

The same answers can be used more then once, or not at all, as you see fit.	The same answers can be used more then once, or not at all, as you see fit.
Line 1768 problem	Line 1700 problem
.	.
\layout Enumerate	\layout Enumerate

In the drop-down option box as seen in	In the drop-down option box as seen in figure
\begin_inset LatexCommand \ref{Creating a new problem resource}	\begin_inset LatexCommand \ref{Creating a new problem resource}

\end_inset	\end_inset
Line 1800 Click the	Line 1732 Click the
Edit	Edit
\series default	\series default
button above the sample problem to enter edit mode.	button above the sample problem to enter edit mode.
\begin_float fig	\begin_inset Float figure
	placement htbp
	wide false
	collapsed false

\layout Standard	\layout Standard
\align center	\align center

\begin_inset Figure size 476 276	\begin_inset Graphics FormatVersion 1
file optionResponseEditing.eps	filename optionResponseEditing.eps
width 3 80	display color
flags 9	size_type 1
	width 80page%
	rotateOrigin center
	lyxsize_type 1
	lyxwidth 476pt
	lyxheight 276pt
\end_inset	\end_inset


Line 1820 Option Response Editor	Line 1760 Option Response Editor
\end_inset	\end_inset


\end_float	\end_inset

You should see the Option Response page open up, which should look something	You should see the Option Response page open up, which should look something
like what you see in figure	like what you see in figure
\begin_inset LatexCommand \ref{Option Response Editor Figure}	\begin_inset LatexCommand \ref{Option Response Editor Figure}
Line 1842 Locate the	Line 1783 Locate the
Max Number of Shown Foils	Max Number of Shown Foils
\series default	\series default
element and type a number from 1 to 8 to display that number of questions.	element and type a number from 1 to 8 to display that number of questions.
You cannot display more then one foil from each concept group, so this	You cannot display more than one foil from each concept group, so this
option will only reduce the number of foils displayed, if it is less then	option will only reduce the number of foils displayed, if it is less than
the number of concept groups in your Option Response problem.	the number of concept groups in your Option Response problem.
\layout Enumerate	\layout Enumerate

Line 1867 Save Changes	Line 1808 Save Changes
Save Changes	Save Changes
\series default	\series default
button, your option will not be selectable below.	button, your option will not be selectable below.
\layout Enumerate	(You will delete unwanted options in the last step.)

To delete the irrelevant options from the Option Response question, select
that option from the
\series bold
Delete Option
\series default
dropdown, and hit the Save Changes button.
Do that for each option you wish to remove.
\layout Enumerate	\layout Enumerate

Now, you need to define the question foils.	Now, you need to define the question foils.
Line 1926 In the Hint area, provide a helpful hint	Line 1859 In the Hint area, provide a helpful hint
Save Changes	Save Changes
\series default	\series default
button.	button.
	\layout Enumerate

	Make sure all the options you want to delete are not used for any of your
	foils
	\begin_inset Foot
	collapsed true

	\layout Standard

	If a deleted option is used in a foil, it will appear in a text box in the

	\series bold
	Correct Option
	\series default
	area for that foil.
	To make the drop-down box reappear, type an option already defined in the

	\series bold
	Select Options
	\series default
	field, and hit
	\series bold
	Submit Changes
	\series default
	.
	A drop-down box will reappear.
	\end_inset

	.
	To delete the irrelevant options from the Option Response question, select
	that option from the
	\series bold
	Delete an Option
	\series default
	drop down, and hit the
	\series bold
	Save Changes
	\series default
	button.
	Do that for each option you wish to remove.
	\layout Subsubsection

	Simple Option Response: No Concept Groups
	\layout Standard

	If you select
	\series bold
	Simple Option Response
	\series default
	from the drop-down box, you get a template that will allow you to enter
	up to eight foils with no grouping.
	The system will randomly mix these foils when presenting them to the student.
	You can have more foils then the
	\series bold
	Max Num of Shown Foils
	\series default
	so that each student will not have the identical foils.
\layout Subsection	\layout Subsection

Creating a String Response Problem	Creating a String Response Problem
\layout Standard	\layout Standard

To create an String Response problem, create a new resource as described	To create a String Response problem, create a new resource as described
in section	in section
\begin_inset LatexCommand \ref{Creating New Content Pages}	\begin_inset LatexCommand \ref{Creating New Content Pages}

Line 1963 problem	Line 1953 problem
.	.
\layout Enumerate	\layout Enumerate

In the drop-down option box as seen in	In the drop-down option box as seen in figure
\begin_inset LatexCommand \ref{Creating a new problem resource}	\begin_inset LatexCommand \ref{Creating a new problem resource}

\end_inset	\end_inset

, select	, select
\series bold	\series bold
Simple String Response Problem	String Response Problem
\series default	\series default
, and click the	, and click the
\series bold	\series bold
Line 1984 Click the	Line 1974 Click the
Edit	Edit
\series default	\series default
button above the sample problem to enter edit mode.	button above the sample problem to enter edit mode.
\begin_float fig	\begin_inset Float figure
	placement htbp
	wide false
	collapsed false

\layout Standard	\layout Standard
\align center	\align center

\begin_inset Figure size 476 320	\begin_inset Graphics FormatVersion 1
file stringResponseEditor.eps	filename stringResponseEditor.eps
width 3 80	display color
flags 9	size_type 1
	width 80page%
	rotateOrigin center
	lyxsize_type 1
	lyxwidth 476pt
	lyxheight 320pt
\end_inset	\end_inset


Line 2004 String Response Editor	Line 2002 String Response Editor
\end_inset	\end_inset


\end_float	\end_inset

You should see the String Response editor page open up, which should look	You should see the String Response editor page open up, which should look
something like what you see in figure	something like what you see in figure
\begin_inset LatexCommand \ref{String Response Editor Figure}	\begin_inset LatexCommand \ref{String Response Editor Figure}
Line 2014 String Response Editor	Line 2013 String Response Editor
.	.
\layout Enumerate	\layout Enumerate

Clear the text from the Text Block at the top of the problem, and type in	Clear the text from the
your problem's question.	\series bold
	Text Block
	\series default
	at the top of the problem, and type in your problem.
\layout Enumerate	\layout Enumerate

In the	In the
Line 2025 Answer Box	Line 2027 Answer Box
, type the correct answer.	, type the correct answer.
\layout Enumerate	\layout Enumerate

Select the answer condition from the drop down box.	Select the answer condition from the drop-down.
There are three cases to choose from:	There are three cases to choose from:
\begin_deeper	\begin_deeper
\layout Enumerate	\layout Enumerate
Line 2043 Case Sensitive	Line 2045 Case Sensitive
\end_inset	\end_inset

.	.
For example, this is useful in Chemistry, where HO and Ho are completely	For example, this is useful in chemistry, where HO and Ho are completely
different answers	different answers
\begin_float footnote	\begin_inset Foot
\end_deeper	collapsed true

\layout Standard	\layout Standard


Line 2059 HO	Line 2062 HO
Ho	Ho
\series default	\series default
is the element 67, Holmium, in the Lanthanides.	is the element 67, Holmium, in the Lanthanides.
\end_float	\end_inset

.	.
The student must match the case of the answer.	The student must match the case of the answer.
\begin_deeper
\layout Enumerate	\layout Enumerate


Line 2073 ci	Line 2076 ci
\begin_inset Quotes eld	\begin_inset Quotes eld
\end_inset	\end_inset

Case Insenstive	Case Insensitive
\begin_inset Quotes erd	\begin_inset Quotes erd
\end_inset	\end_inset

Line 2137 Multiple Choice	Line 2140 Multiple Choice

.	.
The student's answers must contain the same letters as the question author's,	The student's answers must contain the same letters as the question author's,
but order is unimportent.	but order is unimportant.
This is usually used to give a multiple choice question in the question's	This is usually used to give a multiple choice question in the question's

\series bold	\series bold
Line 2195 abcg	Line 2198 abcg
.	.
\layout Standard	\layout Standard

It is conventional to tell the students whether the question is case sensitive	It is conventional to inform the students if the problem is case sensitive,
or not.	or that the order of the answers doesn't matter.
\end_deeper	\end_deeper
\layout Enumerate	\layout Enumerate

Line 2207 Single Line Text Entry Area	Line 2210 Single Line Text Entry Area
block and set a length in the Size box.	block and set a length in the Size box.
This will only affect the size of the box on the screen; if you set the	This will only affect the size of the box on the screen; if you set the
box size to 2, the student can still enter 3 or more letters in their answer.	box size to 2, the student can still enter 3 or more letters in their answer.
\begin_deeper
\layout Comment

This seems like a great feature to either eliminate, or make useful.
Allowing the teacher to limit it to 3, and then not letting the student
type more then 3 chars might be a way of giving the student a hint.
Probably not worth it, as the problem text can always just say
\begin_inset Quotes eld
\end_inset

Pick two of the following
\begin_inset Quotes erd
\end_inset

.
This is probably not a useful feature.
\end_deeper
\layout Enumerate	\layout Enumerate

Scroll down to the Hint element, and type some text that will help students	Scroll down to the
when they answer incorrectly.	\series bold
	Hint
	\series default
	element, and type some text that will help students when they answer incorrectl
	y, or delete the hint by setting the
	\series bold
	Delete
	\series default
	field to
	\series bold
	Yes
	\series default
	.
\layout Enumerate	\layout Enumerate

Click the Submit Changes button.	Click the
	\series bold
	Submit Changes
	\series default
	button.
\layout Subsection	\layout Subsection

Creating Numerical Response And Formula Response Problems	Creating Numerical Response And Formula Response Problems
Line 2239 Creating Numerical Response And Formula	Line 2241 Creating Numerical Response And Formula
Numerical Response problems are answered by entering a number and an optional	Numerical Response problems are answered by entering a number and an optional
unit.	unit.
For instance, a numerical response problem might have an answer of	For instance, a numerical response problem might have an answer of
\begin_inset Formula $ 2m/s^{2} $	\begin_inset Formula $2m/s^{2}$
\end_inset	\end_inset

.	.
Formula Response problems are answered by entering a mathematical formula.	Formula Response problems are answered by entering a mathematical formula.
For instance, a numerical response problem might have an answer of	For instance, a numerical response problem might have an answer of
\begin_inset Formula $ x^{2}+11 $	\begin_inset Formula $x^{2}+11$
\end_inset	\end_inset

.	.
The answer may be in any equivalent format.	The answer may be in any equivalent format.
For instance, for	For instance, for
\begin_inset Formula $ x^{2}+11 $	\begin_inset Formula $x^{2}+11$
\end_inset	\end_inset

, the system will accept	, the system will also accept
\begin_inset Formula $ x*x-11 $	\begin_inset Formula $x*x+11$
\end_inset	\end_inset

or	or
\begin_inset Formula $ x^{2}+21-10 $	\begin_inset Formula $x^{2}+21-10$
\end_inset	\end_inset

as well.	.
\layout Standard	\layout Standard

Creating Numerical Response and Formula Response problems starts the same	Creating Numerical Response and Formula Response problems starts the same
as the other problem types, but because of the power of Numerical Response	as the other problem types, but because of the power of Numerical Response
and Formula Response problems, it is too difficult to cover them in this	and Formula Response problems, they are covered in their own section after
tutorial.	the end of the tutorial.
For more information about these problem types, please see section	For more information about these problem types, please see section
\begin_inset LatexCommand \ref{Numerical Response}	\begin_inset LatexCommand \ref{Numerical Response}

Line 2285 Creating Numerical Response and Formula	Line 2287 Creating Numerical Response and Formula
Publishing Your Resources	Publishing Your Resources
\layout Standard	\layout Standard

In order to make the content you've created available for courses to use,	In order to make the content you've created available for use in courses,
you must publish your content.	you must publish your content.
LON-CAPA provides an easy interface for publishing your content pages,	LON-CAPA provides an easy interface for publishing your content pages,
problem resources, and sequences.	problem resources, and sequences.
A common interface allows you to specify title, author information, keywords,	You can specify title, author information, keywords, and other metadata.
and other metadata.	LON-CAPA uses this metadata for many things, and it's important to fill
LON-CAPA uses this metadata for many things, and it's importent to fill
the metadata out as accurately as possible.	the metadata out as accurately as possible.
\layout Subsection	\layout Subsection

Line 2324 data about data	Line 2325 data about data
For instance, if you create a problem and neglect to say in the title or	For instance, if you create a problem and neglect to say in the title or
subject of the problem what it is about, then a human who wants to use	subject of the problem what it is about, then a human who wants to use
that problem would have to read the problem itself to see what it was about,	that problem would have to read the problem itself to see what it was about,
which is much more difficult then just reading a title.	which is much more difficult than just reading a title.
A computer trying to do the same thing would just be out of luck; it is	A computer trying to do the same thing would just be out of luck; it is
too stupid to understand the problem statement at all.	too stupid to understand the problem statement at all.
\layout Standard	\layout Standard

One example of metadata you use all the time is the <TITLE> of a webpage,	One example of metadata is the <title> of a web page, which usually shows
which usually shows up in the title bar of the browser.	up in the title bar of the browser.
That's information about the webpage itself, not actually part of the web	That's information about the web page itself, not actually part of the
page.	web page.
People use it when they bookmark a page, so they know what the page is.	People use the title information when they bookmark a page, so they know
	what the page is.
Search engines use it as a clue about the content of the web page.	Search engines use it as a clue about the content of the web page.
\layout Subsection	\layout Subsection

Line 2350 Publishing A Resource	Line 2352 Publishing A Resource

\layout Standard	\layout Standard

\begin_float fig
	\begin_inset Float figure
	placement htbp
	wide false
	collapsed false

\layout Standard	\layout Standard
\align center	\align center

\begin_inset Figure size 476 168	\begin_inset Graphics FormatVersion 1
file constructionSpaceForPublishing.eps	filename constructionSpaceForPublishing.eps
width 3 80	display color
flags 9	size_type 1
	width 80page%
	rotateOrigin center
	lyxsize_type 1
	lyxwidth 476pt
	lyxheight 168pt
\end_inset	\end_inset


Line 2370 Construction Space for Publishing	Line 2381 Construction Space for Publishing
\end_inset	\end_inset


\end_float	\end_inset

To publish a resource, log in and choose your role to be an Author.	To publish a resource, log in and choose your role to be an Author.
Then click	Then click
\series bold	\series bold
Line 2388 CSTR	Line 2400 CSTR
Publish	Publish
\series default	\series default
button for the resource you wish to publish.	button for the resource you wish to publish.
\begin_float fig	\begin_inset Float figure
	placement htbp
	wide false
	collapsed false

\layout Standard	\layout Standard
\align center	\align center

\begin_inset Figure size 476 338	\begin_inset Graphics FormatVersion 1
file publishMetadata.eps	filename publishMetadata.eps
width 3 80	display color
flags 9	size_type 1
	width 80page%
	rotateOrigin center
	lyxsize_type 1
	lyxwidth 476pt
	lyxheight 338pt
\end_inset	\end_inset


Line 2408 Publishing Metadata Screen	Line 2428 Publishing Metadata Screen
\end_inset	\end_inset


\end_float	\end_inset

You'll get a metadata screen that should look something like figure	You'll get a metadata screen that should look something like figure
\begin_inset LatexCommand \ref{Publishing Metadata Screen Figure}	\begin_inset LatexCommand \ref{Publishing Metadata Screen Figure}

Line 2422 Publishing Metadata Screen	Line 2443 Publishing Metadata Screen

\layout Standard	\layout Standard

The language is the language the problem is written in.	The
The Publisher/Owner is the person who owns the problem; it should be the	\series bold
email address where anybody with questions about the resource can contact	Language
someone who can help them.	\series default
In smaller environments, this is likely to be the author.	is the language the problem is written in.
In larger environments, it may be a coordinator or manager.	The
	\series bold
	Publisher/Owner
	\series default
	is the LON-CAPA user who owns the problem.
\layout Standard	\layout Standard

The	The
Line 2453 pulley	Line 2478 pulley
\end_inset	\end_inset

as a key word.	as a key word.
LON-CAPA pulls out likely-looking keywords for you so you can just click	LON-CAPA pulls out words used in the text of the resource for you so you
on them to make them keywords.	can just click on their check boxes to make them keywords.

\series bold	\series bold
Additional keywords	Additional keywords
Line 2472 statics	Line 2497 statics
, even though it doesn't appear in the original problem, because Physics	, even though it doesn't appear in the original problem, because Physics
uses that as a classification of problem type.	uses that as a classification of problem type.

	\series bold
	Additional Keywords
	\series default
	are also useful when publishing graphics.
\layout Standard	\layout Standard

Finally, you need to set the copyright and distribution notice.	Finally, you need to set the copyright and distribution permissions in the
This setting controls who is allowed to use your resource.

	\series bold
	COPYRIGHT/DISTRIBUTION
	\series default
	drop-down.
	This setting controls who is allowed to use your resource as follows:
\layout Itemize	\layout Itemize


Line 2542 In order to create a useful course, we n	Line 2575 In order to create a useful course, we n
so that students can use them.	so that students can use them.
\layout Subsection	\layout Subsection

Binding Together Resources In One Map: Page	Creating Sequences
\begin_inset LatexCommand \index{Page}	\begin_inset LatexCommand \index{Sequence}

\end_inset	\end_inset


\layout Standard	\layout Standard

\begin_float fig	A
	\series bold
	Sequence
	\series default
	is a series of resources that can be navigated using the
	\series bold
	NAV
	\series default
	remote control button, or by using the arrow keys on the remote control.

\layout Standard	\layout Standard
\align center

\begin_inset Figure size 429 66
file mapEditingButton.eps
flags 9

	\begin_inset Float figure
	placement htbp
	wide false
	collapsed false

	\layout Standard
	\align center

	\begin_inset Graphics FormatVersion 1
	filename mapEditorSelection.eps
	display color
	size_type 1
	width 40page%
	rotateOrigin center
	lyxsize_type 1
	lyxwidth 238pt
	lyxheight 83pt
\end_inset	\end_inset


\layout Caption	\layout Caption

Map Editing Button	Map Editor Selection
\begin_inset LatexCommand \label{Map Editing Button Figure}	\begin_inset LatexCommand \label{Map Editor Selection Figure}

\end_inset	\end_inset


\end_float	\end_inset
To join several resources into one page, you need to create a
\series bold	To create a Sequence resource, create a new resource as described in section
Map
\series default
of type
\series bold
Page
\series default
.
To create Page resource, create a new resource as described in section

\begin_inset LatexCommand \ref{Creating New Content Pages}	\begin_inset LatexCommand \ref{Creating New Content Pages}

Line 2590 Page	Line 2637 Page
\begin_inset Quotes eld	\begin_inset Quotes eld
\end_inset	\end_inset

page	sequence
\begin_inset Quotes erd	\begin_inset Quotes erd
\end_inset	\end_inset

Line 2598 page	Line 2645 page
\begin_inset Quotes eld	\begin_inset Quotes eld
\end_inset	\end_inset

.page	.sequence
\begin_inset Quotes erd	\begin_inset Quotes erd
\end_inset	\end_inset

Line 2607 page	Line 2654 page
\begin_inset Quotes eld	\begin_inset Quotes eld
\end_inset	\end_inset

.page	.sequence
\begin_inset Quotes erd	\begin_inset Quotes erd
\end_inset	\end_inset

, you should see a screen as in figure	, you should see a screen as in figure
\begin_inset LatexCommand \ref{Map Editing Button Figure}	\begin_inset LatexCommand \ref{Map Editor Selection Figure}

\end_inset	\end_inset

.	.
Click the button to get to the sequence editor.	You can use either the advanced editor or the simplified editor.
	\layout Subsection
\begin_float fig
	Creating a Simple .sequence With The Simple Editor
\layout Standard	\layout Standard
\align center

\begin_inset Figure size 476 226
file mapEditInitial.eps
width 3 80
flags 11

	\begin_inset Float figure
	placement htbp
	wide false
	collapsed false

	\layout Standard
	\align center

	\begin_inset Graphics FormatVersion 1
	filename mapSimpleEditor.eps
	display color
	size_type 1
	width 80page%
	rotateOrigin center
	lyxsize_type 1
	lyxwidth 476pt
	lyxheight 250pt
\end_inset	\end_inset


\layout Caption	\layout Caption

Initial Map Editor	Simple Map Editor
\begin_inset LatexCommand \label{Initial Map Editor FIgure}	\begin_inset LatexCommand \label{Simple Map Editor}

\end_inset	\end_inset


\end_float
After the system notices the map does not yet exist and creates it for you.
You should the initial map editor as seen in figure
\begin_inset LatexCommand \ref{Initial Map Editor FIgure}

\end_inset	\end_inset

.	After creating a new .sequence resource and getting the editor selection
Note there are two windows.	prompt (figure
One is the workspace, and one is the window which will contain information	\begin_inset LatexCommand \ref{Map Editor Selection Figure}
as you add resources.
\layout Subsection

About The Editor
\layout Standard

\begin_float fig	\end_inset
\layout Caption

Example of the Map Editor	), click the
\begin_inset LatexCommand \label{Map Editor Example Figure}	\series bold
	Simple Edit
	\series default
	button to get to the simple map editor, which appears in figure
	\begin_inset LatexCommand \ref{Simple Map Editor}

\end_inset	\end_inset

	.
\end_float
Maps are very powerful and can do a lot.
They can make decisions as the user progresses, and go down different paths
under different circumstances.
For instance, a map can go down one path if the user gets a problem right,
and another path if they don't.

\layout Standard	\layout Standard

To facilitate editing these powerful entities, LON-CAPA has a map editor	The Simple Editor can create .sequences and .pages which are linear, which
that helps you take advantage of this power, as seen in figure	means they have no branches or conditions.
\begin_inset LatexCommand \ref{Map Editor Example Figure}	\layout Standard

\end_inset

.	On the right side of the simple editor is the
The map editor can display the different paths in your browser, and allow
you to edit, insert, and delete resources from your map.
The editor has a
\series bold	\series bold
Start	Target
\series default	\series default
area and a	, which represents the map you are currently building.
	On the left side is the
\series bold	\series bold
Finish	Import
\series default	\series default
area.	area, which represents a work area you can use for your convenience to
The students in the course will progress along on path or another, depending	load and manipulate resource you may wish to include in your map.
on decisions made at each resource, as explained later.	Using the three buttons in the middle of the screen, from top to bottom
Different paths are represented with different lines in the map editor.	you can cut things out of the Target, copy from the Target to the Import,
In the example figure, there are two paths the student can go down, depending	and copy from the Import to the Target, respectively.
on whether or not they get the problem at the branch point correct.	\layout Standard
By the end of this section, we'll create the map represented in this figure.
	On both sides of the screen, you can do a Group Search and a Group Import.
	A Group Search allows you to run a search, then import selected results
	from that search into either directly into your Map, or into your Import
	space.
	Checkboxes will appear next to the results in the Group Search, and you
	can click the resource you wish to add to your map in the order that you
	want them added.
	After you select the resource, you will be presented with a screen that
	allows you to change the order of the selected resources, then you will
	be able to import the selected resources and work with them.
	\layout Standard

	A Group Import works in a similar fashion, but allows you to use the LON-CAPA
	network browser to select your resources.
\layout Standard	\layout Standard

The branching ability can obviously be used to help the student understand	On the Import side, you can also browse for another Map, and load the resources
the concept in the problem by having them go through some extra material	used in that map into your Import workspace.
based on their performance, but the total uses of this feature are limited	You can also discard the selected resources, clear all the resources, and
only by your imagination.	view the selected resource from the buttons on the Import side of the screen.

	\layout Standard

	Both list boxes support standard multi-select mechanisms as used in your
	OS.
\layout Subsection	\layout Subsection

Creating a Simple Map: Page	Creating a Simple .sequence With The Advanced Editor
\layout Standard	\layout Standard

To add a resource to the map:	After creating a new .sequence resource and getting the editor selection
\layout Enumerate	prompt (figure
	\begin_inset LatexCommand \ref{Map Editor Selection Figure}

	\end_inset

	), click the
	\series bold
	Advanced Edit
	\series default
	button to get to the advanced map editor.

	\begin_inset Float figure
	placement htbp
	wide false
	collapsed false

Click on an unused light gray area.
\begin_float fig
\layout Standard	\layout Standard
\align center	\align center

\begin_inset Figure size 476 242	\begin_inset Graphics FormatVersion 1
file mapEditFirstClick.eps	filename mapAdvancedEditorNew.eps
width 3 80	display color
flags 9	size_type 1
	width 80page%
	rotateOrigin center
	lyxsize_type 1
	lyxwidth 476pt
	lyxheight 205pt
\end_inset	\end_inset


\layout Caption	\layout Caption

Map Editor after clicking on the box labelled	Initial Map Editor
\begin_inset Quotes eld	\begin_inset LatexCommand \label{Initial Map Editor FIgure}

\end_inset	\end_inset

here
\begin_inset Quotes erd	\end_inset

	You should see the initial map editor as shown in figure
	\begin_inset LatexCommand \ref{Initial Map Editor FIgure}

\end_inset	\end_inset

.	.
	Note there are two windows: One is the workspace, and one is a secondary
\begin_inset LatexCommand \label{Map Editor First Click Figure}	window which will contain information as you add resources.
	\layout Enumerate


	\begin_inset Float figure
	placement htbp
	wide false
	collapsed false

	\layout Standard
	\align center

	\begin_inset Graphics FormatVersion 1
	filename mapClickedStart.eps
	display color
	size_type 1
	width 80page%
	rotateOrigin center
	lyxsize_type 1
	lyxwidth 476pt
	lyxheight 221pt
\end_inset	\end_inset


\end_float	\layout Caption
In figure
\begin_inset LatexCommand \ref{Map Editor First Click Figure}	After clicking
	\series bold
	Start
	\series default
	in the Map Constructor
	\begin_inset LatexCommand \label{Clicked Start Figure}

\end_inset	\end_inset

, the map editor after clicking on the area labelled
\begin_inset Quotes eld
\end_inset	\end_inset

here	Click the
\begin_inset Quotes erd	\series bold
	Start
	\series default
	box.
	You'll see what you see in figure
	\begin_inset LatexCommand \ref{Clicked Start Figure}

\end_inset	\end_inset

is shown.	.
In that figure, lines have been added to show where the box boundaries	Click
are for the purposes of demonstration.	\series bold
This is to allow you to stay in sync with this tutorial; normally this	Link Resource
doesn't matter.	\series default
	in the secondary window, then click on the
\begin_deeper	\series bold
	Finish
	\series default
	box.
	\begin_inset Float figure
	placement htbp
	wide false
	collapsed false

\layout Standard	\layout Standard
	\align center

Note that the contents of the seperate window have changed.	\begin_inset Graphics FormatVersion 1
\end_deeper	filename mapStraightened.eps
	display color
	size_type 1
	height 25page%
	rotateOrigin center
	lyxsize_type 1
	lyxwidth 70pt
	lyxheight 210pt
	\end_inset


	\layout Caption

	Straightened Map
	\begin_inset LatexCommand \label{Striaghtened map}

	\end_inset


	\end_inset

	After that, click
	\series bold
	Straighten
	\series default
	.
	You should see something like figure
	\begin_inset LatexCommand \ref{Striaghtened map}

	\end_inset

	.
	This creates a simple map that flows from beginning to end.
\layout Enumerate	\layout Enumerate

\begin_float fig
	\begin_inset Float figure
	placement htbp
	wide false
	collapsed false

\layout Standard	\layout Standard
\align center	\align center

\begin_inset Figure size 476 218	\begin_inset Graphics FormatVersion 1
file mapNewResource.eps	filename mapInsertResource.eps
width 3 80	display color
flags 9	size_type 1
	height 30page%
	rotateOrigin center
	lyxsize_type 1
	lyxwidth 271pt
	lyxheight 252pt
\end_inset	\end_inset


\layout Caption	\layout Caption

Map Resource Editor	Inserting a Resource
\begin_inset LatexCommand \label{Map Resource Editor Figure}	\begin_inset LatexCommand \label{Inserting a Resource Figure}

\end_inset	\end_inset


\end_float	\end_inset
Click on
	To insert a resource into the flow, click the black line with two arrows,
	seen between the
\series bold	\series bold
Insert Resource	Start
\series default	\series default
in the secondary window.	and
A
\series bold	\series bold
Resource	Finish
\series default	\series default
will appear in the map editor.	boxes in figure
Click on the new Resource, and you'll get something like Figure	\begin_inset LatexCommand \ref{Striaghtened map}
\begin_inset LatexCommand \ref{Map Resource Editor Figure}
	\end_inset

	.
	In the secondary window, you'll see something like figure
	\begin_inset LatexCommand \ref{Inserting a Resource Figure}

\end_inset	\end_inset

will show appear.	.
Click	Click
\series bold	\series bold
	Insert Resource Into Link
	\series default
	.
	A new resource box will appear in the link.
	Click the resource, which will have the label
	\series bold
	Res
	\series default
	.
	\layout Enumerate

	Click
	\series bold
Browse	Browse
\series default	\series default
, and the	, and the
Line 2814 Browse	Line 2995 Browse
Network Directory Browser	Network Directory Browser
\series default	\series default
will appear,	will appear,
\begin_float fig	\begin_inset Float figure
	placement htbp
	wide false
	collapsed false

\layout Standard	\layout Standard
\align center	\align center

\begin_inset Figure size 476 216	\begin_inset Graphics FormatVersion 1
file mapEditorDirectoryBrowser.eps	filename mapEditorDirectoryBrowser.eps
width 3 80	display color
flags 9	size_type 1
	width 60page%
	rotateOrigin center
	lyxsize_type 1
	lyxwidth 357pt
	lyxheight 162pt
\end_inset	\end_inset


Line 2834 Network Directory Browser	Line 3023 Network Directory Browser
\end_inset	\end_inset


\end_float	\end_inset

looking something like figure	looking something like figure
\begin_inset LatexCommand \ref{Map Editor Network Directory Browser Figure}	\begin_inset LatexCommand \ref{Map Editor Network Directory Browser Figure}

\end_inset	\end_inset

.	.
Press the select button that is next to the resource you want to include.	Press the
\begin_float fig	\series bold
	SELECT
	\series default
	button that is next to the resource you want to place in the chosen resource
	box.
	\begin_inset Float figure
	placement htbp
	wide false
	collapsed false

\layout Standard	\layout Standard
\align center	\align center

\begin_inset Figure size 476 213	\begin_inset Graphics FormatVersion 1
file mapEditorResourceChosen.eps	filename mapEditorResourceChosen.eps
width 3 80	display color
flags 9	size_type 1
	height 30page%
	rotateOrigin center
	lyxsize_type 1
	lyxwidth 42pt
	lyxheight 252pt
\end_inset	\end_inset


Line 2861 Resource Chosen	Line 3064 Resource Chosen

\end_inset	\end_inset

(HTML page)
\end_float	\end_inset

Once you've done that, if you look back at the window that popped up when	Once you've done that, if you look back at the window that popped up when
you clicked on	you clicked on
\series bold	\series bold
Line 2882 URL	Line 3086 URL
\series bold	\series bold
Title	Title
\series default	\series default
if you prefer, following the format you see above.	into the secondary window, if you prefer, following the format you see
	when you've successfully browsed to a resource.
After you click	After you click
\series bold	\series bold
Save Changes	Save Changes
\series default	\series default
, your changes will be saved, and the icons for the resource will appear	, your changes will be set, and the icons for the resource will appear in
in the	the
\series bold	\series bold
Res	Res
\series default	\series default
Line 2898 Res	Line 3103 Res
\end_inset	\end_inset

.	.
	Click
	\series bold
	Save Map
	\series default
	in the bar above your map to save the map.
\begin_deeper	\begin_deeper
\layout Standard	\layout Standard

Line 2908 Clicking on the left icon for a resource	Line 3118 Clicking on the left icon for a resource
\end_deeper	\end_deeper
\layout Enumerate	\layout Enumerate

Let's give practice giving ourselves a bit more space.	Repeat steps two and three for as many resources as you'd like to bind together
Click on the grey space just left of your resource, and select	into one page.
\series bold	You can insert the new resources anywhere you'd like.
Insert Column Right
\series default
.
This will add a column to the right of that space.
Now, click on the bottom row in the grey area, and select
\series bold
Insert Row Above
\series default
.
This gives us enough space to work with.
\layout Enumerate	\layout Enumerate

Now, in the map editor window, click just to the left of the	When you are done adding resources, click the
\series bold	\series bold
Res	Save Map
\series default	\series default
box.	link to save the map.
\begin_float fig
\layout Standard	\layout Standard
\align center

\begin_inset Figure size 357 190	In addition to manually adding in resources, the Advanced Editor also has
file mapSecondWindowSecondResource.eps	the ability to import resource in the same way that the Simple Editor can:
flags 9	From a LON-CAPA network browser window, from a Group Search, or from another
	Map.
\end_inset	\layout Standard

	The advanced editor has many more capabilities which you can explore.
	\layout Subsection

\layout Caption	Page Maps
	\layout Standard

Choosing your second resource	Creating a .page map is the same as creating a sequence map, except that
\begin_inset LatexCommand \label{Map Second Resource Figure}	when choosing the name of the resource, the URL will end with
	\begin_inset Quotes eld
	\end_inset

	.page
	\begin_inset Quotes erd
\end_inset	\end_inset

	.
	Then all resources you add in the map editor will appear on one page together.
	\layout Standard

\end_float	Pages are often used to connect problems in a homework set.
The secondary window will appear as it does in figure	\layout Subsection
\begin_inset LatexCommand \ref{Map Second Resource Figure}

\end_inset	Creating a Course: Top-level Sequence
	\layout Standard

, but for now just choose	In order to view sequences, they need to be part of a
\series bold	\series bold
Insert Resource	course
\series default	\series default
again, not the new options.	.
Insert a resource in the same manner as before.	\begin_inset Float figure
\begin_float fig	placement htbp
	wide false
	collapsed false

\layout Standard	\layout Standard
\align center	\align center

\begin_inset Figure size 476 243	\begin_inset Graphics FormatVersion 1
file mapTwoResources.eps	filename creatingANewCourse.eps
width 3 80	display color
flags 11	size_type 1
	width 40page%
	rotateOrigin center
	lyxsize_type 1
	lyxwidth 238pt
	lyxheight 231pt
\end_inset	\end_inset


\layout Caption	\layout Caption

Two Resource in the Map Editor	Creating a New Course
\begin_inset LatexCommand \label{Two Resources in the Map Editor Figure}	\begin_inset LatexCommand \label{Creating a New Course Figure}

\end_inset	\end_inset


\end_float
You should have something that looks like figure
\begin_inset LatexCommand \ref{Two Resources in the Map Editor Figure}

\end_inset	\end_inset

, though the exact placement may differ.	Courses have a Top-level Map which defines the whole course.
Now we need to link them together.	This top-level map will often itself contain maps corresponding to homework
\layout Enumerate	assignments, chapters, or units.
	To view your maps, you will need to make them part of a course.
Click the Start box.	Only Domain Coordinators can make courses and set their Top-level maps,
In the secondary window, select	so work with your Domain Coordinator if you need to view your maps.
\series bold
Link Resource
\series default
.
The secondary window will prompt you to click on the resource you want
to link it to.
Click the first resource you added to the map.
A new link is created.
\layout Enumerate

Repeat the last step, linking the first resource to the second resource,
and the second resource to
\series bold
Finish
\series default
.
\layout Enumerate

Now, in the editor window, click
\series bold
Save Map
\series default
.
A dialog box will pop up, telling you the map has been saved.
\layout Standard

Now that you
\layout Section	\layout Section

Numerical Response	Numerical Response
Line 3030 Numerical Response	Line 3214 Numerical Response

\end_inset	\end_inset

Problems	And Formula Response Questions
\layout Standard	\layout Standard

Numerical Response problems are very powerful.	Numerical Response problems are very powerful.
In fact, they are so powerful it would be impossible to fully explain what	In fact, they are so powerful it would be impossible to fully explain what
is possible in a document like this.	is possible in a document like this.
This chapter will focus on just getting you started with Numerical Response	This chapter will focus on getting you started with Numerical Response
problems, and showing you some of the possibilities, with no prerequisite	problems, and showing you some of the possibilities, with no prerequisite
knowlege necessary.	knowledge necessary.
The more you learn, the more you will find you can do.	The more you learn, the more you will find you can do.
\layout Standard	\layout Standard

In this chapter and the next, I will use the terms
\series bold
static
\series default
and
\series bold
dynamic
\series default
.

\series bold
Static
\series default
means the object never changes, and is the same for each student.
By contrast,
\series bold
dynamic
\series default
means the value can change, because there is some script that computes
it for each student.
\layout Standard

If you like, you can follow this chapter along as its own tutorial.	If you like, you can follow this chapter along as its own tutorial.
Create a Numerical Response problem using the instructions in section	Create a Numerical Response problem using the instructions in section
\begin_inset LatexCommand \ref{Creating New Content Pages}	\begin_inset LatexCommand \ref{Creating New Content Pages}
Line 3088 Simple Numerical Response	Line 3250 Simple Numerical Response
The Parts of a Numerical Response Problem	The Parts of a Numerical Response Problem
\layout Standard	\layout Standard

\begin_float fig
	\begin_inset Float figure
	placement htbp
	wide false
	collapsed false

\layout Standard	\layout Standard
\align center	\align center

\begin_inset Figure size 476 356	\begin_inset Graphics FormatVersion 1
file numericalResponse1.eps	filename numericalResponse1.eps
width 3 80	display color
flags 9	size_type 1
	width 80page%
	rotateOrigin center
	lyxsize_type 1
	lyxwidth 476pt
	lyxheight 356pt
\end_inset	\end_inset


Line 3108 Numerical Response editor	Line 3279 Numerical Response editor
\end_inset	\end_inset


\end_float	\end_inset

A Numerical Response problem has seven major parts by default, as seen in	A Numerical Response problem has seven major parts by default, as seen in
figure	figure
\begin_inset LatexCommand \ref{Numerical Response Editor Figure}	\begin_inset LatexCommand \ref{Numerical Response Editor Figure}
Line 3129 Script	Line 3301 Script
The Script language is	The Script language is
\series bold	\series bold
Perl	Perl
\begin_float footnote	\series default
\layout Standard

For lots and lots more information about Perl, see the Perl website at http://ww
w.perl.org/ .
\end_float
.	.
You do not need to know Perl to use the Script block, as we will be stepping	You do not need to know Perl to use the
through some advanced examples in this chapter, but knowing Perl can help.	\series bold
	Script
	\series default
	block, as we will be stepping through some advanced examples in this chapter,
	but knowing Perl can help.
\layout Enumerate	\layout Enumerate

Like other problem types, the	Like other problem types, the
Line 3145 Like other problem types, the	Line 3316 Like other problem types, the
Text Block	Text Block
\series default	\series default
is used to display the problem the student will see.	is used to display the problem the student will see.
In addition, you can place things in the	In addition, you can place variables in the
\series bold	\series bold
Text Block	Text Block
\series default	\series default
Line 3177 tolerance	Line 3348 tolerance


\series default	\series default
parameter, which determines how closely the system will require the student	parameter, which determines how closely the system will require the student's
answer to be in order to count it correct.	answer to be in order to count it correct.
For technical reasons, it is almost never a good idea to set this parameter	For technical reasons, it is almost never a good idea to set this parameter
to zero	to zero
\begin_float footnote	\begin_inset Foot
	collapsed true

\layout Standard	\layout Standard

Computers can only approximate computations involving real numbers.	Computers can only approximate computations involving real numbers.
For instance, a computer's [decimal] answer to the simple problem	For instance, a computer's [decimal] answer to the simple problem
\begin_inset Formula $ \frac{1}{3} $	\begin_inset Formula $\frac{1}{3}$
\end_inset	\end_inset

is	is
Line 3219 need	Line 3392 need
\emph default	\emph default
to allow a tolerance factor, or the students will find it nearly impossible	to allow a tolerance factor, or the students will find it nearly impossible
to exactly match the computers idea of the answer.	to exactly match the computers idea of the answer.
\end_float	\end_inset

, though you may find the default too large for some problems.	, though you may find the default too large for some problems.
There are two kinds of tolerance.	There are two kinds of tolerance.
If there is some answer	For some answer
\begin_inset Formula $ a $	\begin_inset Formula $a$
\end_inset	\end_inset

and a tolerance	and a tolerance
\begin_inset Formula $ t $	\begin_inset Formula $t$
\end_inset	\end_inset

,	,
Line 3249 Absolute	Line 3423 Absolute
\end_inset	\end_inset

will take anything in the range	will take anything in the range
\begin_inset Formula $ a\pm t $	\begin_inset Formula $a\pm t$
\end_inset	\end_inset

.	.
So if	So if
\begin_inset Formula $ a=10 $	\begin_inset Formula $a=10$
\end_inset	\end_inset

and	and
\begin_inset Formula $ t=2 $	\begin_inset Formula $t=2$
\end_inset	\end_inset

, then anything between 8 and 12 is acceptable	, then anything between 8 and 12 is acceptable
\begin_float footnote	\begin_inset Foot
\end_deeper	collapsed true

\layout Standard	\layout Standard

For much the same reasons a tolerance is almost always a good idea, it's	For much the same reasons a tolerance is almost always a good idea, it's
Line 3272 For much the same reasons a tolerance is	Line 3447 For much the same reasons a tolerance is
exactly	exactly
\emph default	\emph default

\begin_inset Formula $ a\pm t $	\begin_inset Formula $a\pm t$
\end_inset	\end_inset

will be accepted by the computer.	will be accepted by the computer.
Line 3295 exactly	Line 3470 exactly

is OK.	is OK.
(Don't use too many more zeros, though you can use less if you like.)	(Don't use too many more zeros, though you can use less if you like.)
\end_float	\end_inset

.	.
Any number in the tolerance field	Any number in the tolerance field
\emph on	\emph on
Line 3306 without	Line 3482 without
%	%
\series default	\series default
symbol is an absolute tolerance.	symbol is an absolute tolerance.
\begin_deeper
\layout Enumerate	\layout Enumerate

a	a
Line 3324 Relative	Line 3499 Relative
\end_inset	\end_inset

will take anything in the range	will take anything in the range
\begin_inset Formula $ a\pm at $	\begin_inset Formula $a\pm at$
\end_inset	\end_inset

, where	, where
Line 3334 t	Line 3509 t
is interpreted as a percentage.	is interpreted as a percentage.
Any number in the tolerance field	Any number in the tolerance field
\emph on	\emph on
with	followed by
\emph default	\emph default
a	a
\series bold	\series bold
Line 3342 with	Line 3517 with
\series default	\series default
symbol is a relative tolerance.	symbol is a relative tolerance.
For example,	For example,
\begin_inset Formula $ a=10 $	\begin_inset Formula $a=10$
\end_inset	\end_inset

and	and
\begin_inset Formula $ t=10\% $	\begin_inset Formula $t=10\%$
\end_inset	\end_inset

will accept anything between 9 and 11.	will accept anything between 9 and 11.
Line 3409 min,max	Line 3584 min,max
\end_inset	\end_inset

are the same.	are the same.
\begin_deeper	A significant figure specification of
\layout Comment	\begin_inset Quotes eld
	\end_inset

Confirm this.	3,4
\end_deeper	\begin_inset Quotes erd
	\end_inset

	means both
	\begin_inset Quotes eld
	\end_inset

	1.30
	\begin_inset Quotes erd
	\end_inset

	and
	\begin_inset Quotes eld
	\end_inset

	1.300
	\begin_inset Quotes erd
	\end_inset

	are acceptable.
\layout Enumerate	\layout Enumerate

The	The
Line 3428 Finally, the	Line 3623 Finally, the
\series bold	\series bold
Hint	Hint
\series default	\series default
provides a place to help students who get the problem incorrect the first	should contain text which will help the students when they answer incorrectly.
time.
\layout Subsection	\layout Subsection

Simple Numerical Response Answer	Simple Numerical Response Answer
Line 3471 Answer	Line 3665 Answer
\series bold	\series bold
Hint	Hint
\series default	\series default
has been set to something appropriate for this problem (unless this problem	has been set to something appropriate for this problem.
is being given to very young children).
Everything else has the default values from when the problem was created.	Everything else has the default values from when the problem was created.
\layout Standard	\layout Standard

Line 3488 View	Line 3681 View
yourself.	yourself.
Note the last box in the HTML page has the answer LON-CAPA is looking for	Note the last box in the HTML page has the answer LON-CAPA is looking for
conveniently displayed for you, along with the range the computer will	conveniently displayed for you, along with the range the computer will
accept and the number of significant digits the computer requires.	accept and the number of significant digits the computer requires when
	viewed by an
	\series bold
	Author
	\series default
	.
\layout Standard	\layout Standard

As you're playing with the problem, if you use up all your tries or get	As you're playing with the problem, if you use up all your tries or get
Line 3525 A script consists of several	Line 3723 A script consists of several
\series bold	\series bold
statements	statements
\series default	\series default
, seperated by	, separated by
\series bold	\series bold
semi-colons	semi-colons
\series default	\series default
Line 3539 statement	Line 3737 statement


\series default	\series default
is the smallest kind of instruction to the computer you can give.	is the smallest kind of instruction to the computer.
Most problems will be built from several statements.	Most problems will be built from several statements.

\layout Standard	\layout Standard
Line 3563 comments	Line 3761 comments
very	very
\emph default	\emph default
good idea to adopt some sort of commenting standard, especially if you	good idea to adopt some sort of commenting standard, especially if you
are working in a group or others may use your problems in the future.	are working in a group or you believe other people may use your problems
\layout Standard	in the future.
	\layout Itemize

One of the simplest statements in LON-CAPA is a	One of the simplest statements in LON-CAPA is a
\series bold	\series bold
Line 3576 variable assignment	Line 3775 variable assignment
variable	variable
\series default	\series default
can hold any value in it.	can hold any value in it.
Simple values, such as a number or a string of text, start with a	The variable name must start with a
\series bold	\series bold
$	$
\series default	\series default
Line 3586 $	Line 3785 $
Script	Script
\series default	\series default
, you need to assign to variables before you use them.	, you need to assign to variables before you use them.
Put the program in Figure	Put this program into the
\begin_float fig
\layout LyX-Code
\align center
$variable = 3;
\layout Caption
\pextra_type 3 \pextra_widthp 40

A simple script with a variable
\begin_inset LatexCommand \label{A simple script with a variable}

\end_inset


\end_float

\begin_inset LatexCommand \ref{A simple script with a variable}

\end_inset

into the
\series bold	\series bold
Script	Script
\series default	\series default
field of the Numerical Response.	field of the Numerical Response:
This creates a simple variable named	\begin_deeper
	\layout LyX-Code

	$variable = 3;
	\layout Standard

	This creates a variable named
\series bold	\series bold
variable	variable
\series default	\series default
Line 3625 variable	Line 3810 variable

.	.
That's one statement.	That's one statement.
	\end_deeper
\layout Standard	\layout Standard

Variable names are	Variable names are
Line 3637 case sensitive	Line 3823 case sensitive

\layout Standard	\layout Standard

Getting variable names right is a skill.
Variable names should not be too long, because they become easy to mistype.
Variable names should also not be too short, with the exception of some
conventionally short variable names we'll talk about later.
\layout Standard

There are many variable naming conventions, covering both how to name and	There are many variable naming conventions, covering both how to name and
how to capatalize variables	how to capitalize variables
\begin_float footnote	\begin_inset Foot
	collapsed true

\layout Standard	\layout Standard

The author favors	The author favors
Line 3655 capsOnNewWords	Line 3837 capsOnNewWords
.	.
Some people use	Some people use
\family typewriter	\family typewriter
underscore_to_seperate_words	underscore_to_separate_words
\family default	\family default
.	.
Many use uppercase letters to specify constants like	Many use uppercase letters to specify constants like
Line 3672 GOLDEN_MEAN	Line 3854 GOLDEN_MEAN
StartWithCapatalization	StartWithCapatalization
\family default	\family default
.	.
What's really importent is to be consistent, so you don't have to guess	What's really important is to be consistent, so you don't have to guess
whether the variable you're thinking of is	whether the variable you're thinking of is
\family typewriter	\family typewriter
coefFriction	coefFriction
Line 3686 CoefFriction	Line 3868 CoefFriction
COEF_FRICTION	COEF_FRICTION
\family default	\family default
, or something else.	, or something else.
\end_float	\end_inset

.	.
It is a good idea to adopt a standard.	It is a good idea to adopt a standard.
If you are working with a group, you may wish to discuss it in your group	If you are working with a group, you may wish to discuss it in your group
Line 3721 $variable	Line 3904 $variable
$variable2 = $variable + 2;	$variable2 = $variable + 2;
\layout Standard	\layout Standard

Now there's a variable called	Now there is a variable called
\family typewriter	\family typewriter
$variable2	$variable2
\family default	\family default
with the value	with the the number
\begin_inset Quotes eld	\begin_inset Quotes eld
\end_inset	\end_inset

Line 3733 $variable2	Line 3916 $variable2
\begin_inset Quotes erd	\begin_inset Quotes erd
\end_inset	\end_inset

.	as its value.

\layout Standard	\layout Standard

Line 3784 stringVar	Line 3967 stringVar
\layout Standard	\layout Standard

If you are following this chapter as a tutorial, add the previous two lines	If you are following this chapter as a tutorial, add the previous two lines
and save the problem.	to your
	\series bold
	Script
	\series default
	and submit the changes for the problem.
There's no need to view it; there's still no visible change.	There's no need to view it; there's still no visible change.
\layout Subsubsection	\layout Subsubsection

Line 3814 See the 3: $variable<br />	Line 4001 See the 3: $variable<br />
See the string: <b>$stringVar</b><br />	See the string: <b>$stringVar</b><br />
\layout Standard	\layout Standard

\begin_float fig
	\begin_inset Float figure
	placement htbp
	wide false
	collapsed false

\layout Standard	\layout Standard
\align center	\align center

\begin_inset Figure size 353 99	\begin_inset Graphics FormatVersion 1
file numericalResponseVarInText.eps	filename numericalResponseVarInText.eps
flags 9	display color
	size_type 0
	rotateOrigin center
	lyxsize_type 1
	lyxwidth 353pt
	lyxheight 99pt
\end_inset	\end_inset


Line 3833 Result of Variables in the Text Block	Line 4029 Result of Variables in the Text Block
\end_inset	\end_inset


\end_float	\end_inset

If you save that and hit	If you save that and hit
\series bold	\series bold
View	View
Line 3882 Answer	Line 4079 Answer
This means you can compute an answer to a question, which we'll see in	This means you can compute an answer to a question, which we'll see in
a bit.	a bit.
If you set the answer of the question to be	If you set the answer of the question to be
\begin_inset Quotes eld	\series bold
\end_inset

$variable	$variable
\begin_inset Quotes erd	\series default
\end_inset	,

(without the quotes),
\series bold	\series bold
Save Changes	Save Changes
\series default	\series default
Line 3901 View	Line 4094 View
\begin_inset Quotes eld	\begin_inset Quotes eld
\end_inset	\end_inset

3	3.0
\begin_inset Quotes erd	\begin_inset Quotes erd
\end_inset	\end_inset

Line 3911 View	Line 4104 View
Calling Functions	Calling Functions
\layout Standard	\layout Standard

Now you've seen how to use variables and stuff, see how to call functions.	With variables, you can store strings or numbers.

	\series bold
	Functions
	\series default
	allow you to manipulate these strings or numbers.
	Functions work like mathematical functions: They take some number of arguments
	in, and return one argument, usually a number or a string for our purposes.
	There are a lot of functions available in LON-CAPA.
	You can see a complete list at http://mileva.lite.msu.edu/loncapadocs/homework/hom
	ework5.html.
	For now, let's just look at some simple examples.
	\layout Standard


	\begin_inset Float figure
	placement htbp
	wide false
	collapsed false

	\layout LyX-Code

	$a = -3.0;
	\layout LyX-Code

	$b = &sin($a);
	\layout LyX-Code

	$c = &pow(3.0, &abs($a));
	\layout Caption

	Some Function Calls
	\begin_inset LatexCommand \label{Some Function Calls Figure}

	\end_inset


	\end_inset

	In the
	\series bold
	Script
	\series default
	block, function names start with
	\series bold
	&
	\series default
	.
	Some example function calls are shown in figure
	\begin_inset LatexCommand \ref{Some Function Calls Figure}

	\end_inset

	.
	You can see that functions can take either variables, numbers, or the results
	of other function calls as parameters.
	The
	\family typewriter
	&sin
	\family default
	function returns the sine of an angle expressed in radians.

	\family typewriter
	&pow
	\family default
	raises the first parameter to the power of the second parameter.

	\family typewriter
	&abs
	\family default
	returns the absolute value of the argument.
\layout Subsubsection	\layout Subsubsection

Randomization	Randomization
Line 3922 Randomization	Line 4185 Randomization

\layout Standard	\layout Standard

One of the most importent functions for LON-CAPA is the RANDOM function.	For LON-CAPA, one of the most important functions is the
	\family typewriter
	random
	\family default
	function.
	Random takes three parameters: a
	\emph on
	lower limit
	\emph default
	, an
	\emph on
	upper limit
	\emph default
	, and an
	\emph on
	interval
	\emph default
	.
	The
	\family typewriter
	&random
	\family default
	function returns a random value between the upper and lower limit, some
	integer number of
	\emph on
	interval
	\emph default
	's away from the lower limit.
	Thus, for example,
	\family typewriter
	&random(1,2,.2)
	\family default
	might return 1, 1.2, 1.4, 1.6, 1.8, or 2.

	\family typewriter
	&random
	\family default
	uses a uniform distribution.
	Other distributions are available in LON-CAPA, and can be found by consulting
	the function list.
	\layout Standard


	\begin_inset Float figure
	placement htbp
	wide false
	collapsed false

	\layout LyX-Code

	$a = &random(1.0,10.0,1.0);
	\layout LyX-Code

	$b = &random(-10.0, -3.0, 1.0);
	\layout LyX-Code

	$answer = $a+$b;
	\layout Caption

	Sample
	\family typewriter
	random
	\family default
	Calls
	\begin_inset LatexCommand \label{Sample Random Calls figure}

	\end_inset


	\end_inset

	If you put the script in figure
	\begin_inset LatexCommand \ref{Sample Random Calls figure}

	\end_inset

	into the
	\series bold
	Script
	\series default
	block (replacing whatever contents might be in the block already), you'll
	get two random variables $a and $b.
	Now, in the
	\series bold
	Text Block
	\series default
	, put
	\begin_inset Quotes eld
	\end_inset

	What is $a plus $b?
	\begin_inset Quotes erd
	\end_inset

	, and in the
	\series bold
	Answer
	\series default
	put
	\begin_inset Quotes eld
	\end_inset

	$answer
	\begin_inset Quotes erd
	\end_inset

	, without the quotes for either of them.
	(It is a good idea to create a variable to hold the answer and call it
	$answer, or some other reasonably standard name.
	Do not try to compute the answer in the
	\series bold
	Answer
	\series default
	field itself; it will not work as you expect.) Now save the problem and

	\series bold
	View
	\series default
	it.
	You'll see a randomized problem.
	\layout Standard

	For each student, the same random number will be used each time they visit
	the problem, but each student will get different random numbers.
	For any but the simplest random problems, you'll want to see several random
	problems to make sure everything is working out correctly.
	This is what the
	\series bold
	Random Seed
	\begin_inset LatexCommand \index{Random Seed}

	\end_inset


	\series default
	field is for.
	To see another randomized version of the problem you've just created, put
	another number into the
	\series bold
	Random Seed
	\series default
	field and hit
	\series bold
	Change
	\series default
	.
	It doesn't really matter what number you put into the field.
	But for any given
	\series bold
	Random Seed
	\series default
	with the same problem, you'll see the same randomized problem generated
	for you.
	(If you change the
	\series bold
	Script
	\series default
	, you are no longer guaranteed to get the same problem.)
	\layout Standard

	If you're doing this as a tutorial, try a few random seeds to see what happens.
\layout Subsection	\layout Subsection

Dynamic, Randomized Problems: Putting It All Together	Dynamic, Randomized Problems: Putting It All Together
\layout Standard	\layout Standard

placeholder	Now you have all the tools to create those wonderful dynamic, randomized
\layout Subsection	problems that you've seen in LON-CAPA.
	\begin_inset Float figure
	placement htbp
	wide false
	collapsed false

For More Information
\layout Standard	\layout Standard
	\align center

	\begin_inset Graphics FormatVersion 1
	filename numericalResponseSlopeProblem.eps
	display color
	size_type 1
	width 80page%
	rotateOrigin center
	lyxsize_type 1
	lyxwidth 476pt
	lyxheight 197pt
	\end_inset


It's always a good idea to look at other people's LON-CAPA problems, especially	\layout Caption
those from the same discipline as your problems, and see what they are
doing.	Slope Problem Parameters
	\begin_inset LatexCommand \label{Slope Problem Parameters Figure}

	\end_inset


	\end_inset

	For example, try filling out your problem with the parameters shown in
	figure
	\begin_inset LatexCommand \ref{Slope Problem Parameters Figure}

	\end_inset

	.

\series bold	\layout Standard
Very often, the easiest way to create a new problem is to copy it and modify
the copy until it does what you need.

	When creating randomized problems, you want to make sure that the problems
	always have an answer.
	Consider what might happen if I had chosen the two slopes
	\emph on
	both
	\emph default
	with the expression
	\family typewriter
	&random(-1.0,1.0,.2)
	\family default
	.
	One out of ten students would get a problem where both slopes were equal,
	which has either no solution (for unequal y-intercepts) or an infinite
	number of solutions (for equal slopes and y-intercepts).
	Both of these cause a division-by-zero error on the division that computes
	the answer.
	There are many ways to avoid this, one of the easiest of which is picking
	one slope negative and one positive.
	This same problem can show up in many other places, too, so be careful.
	\layout Subsection

	Units, Format
	\layout Standard

	Numerical Response problems can require units.
	In the problem editing form, place the desired unit in the
	\series bold
	Unit
\series default	\series default
The more complicated a problem is, the more time you'll save by doing this.	field.
Also, you may find new ideas you can use and elaborate in your problems.	For information about what units the system accepts, see http://capa4.lite.msu.edu
\layout Comment	/demolibrary/Links/UnitsSymbolsT2.html.
	The computer will accept the answer in any of its accepted unit formats.
	For example, if the answer to a problem is
	\begin_inset Quotes eld
	\end_inset

	1ft
	\begin_inset Quotes erd
	\end_inset

	, the computer will accept
	\begin_inset Quotes eld
	\end_inset

	12in
	\begin_inset Quotes erd
	\end_inset

Is there UI for this? Check.	as correct.
\layout Standard	\layout Standard

The full power of the Perl is well outside the scope of this document.	Additionally, you can format the number displayed by the computer as the
Without going into the same level of detail as the previous examples, here's	answer.
some ideas to stimulate your imagination:	For instance, if the answer is one-third, the computer will display that
\layout Itemize	it computed
	\begin_inset Quotes eld
	\end_inset

Variable text.	.333333333
	\begin_inset Quotes erd
\layout Itemize	\end_inset

Perl has several other data structures which might be of use.	as the answer.
You may wish to do one of the many simple Perl tutorials on the Web.	If you'd like to shorten that, you can use the
I recommend searching Google for	\series bold
	Format
	\series default
	field.
	Format strings like
\begin_inset Quotes eld	\begin_inset Quotes eld
\end_inset	\end_inset

perl tutorial	2E
\begin_inset Quotes erd	\begin_inset Quotes erd
\end_inset	\end_inset

.	(without the quotes) will display three significant digits in scientific
\layout Section	notation.
	Format strings like
	\begin_inset Quotes eld
	\end_inset

	2f
	\begin_inset Quotes erd
	\end_inset

	will display two digits after the decimal point.
	\layout Subsection

	For More Information
	\layout Standard

	The full power of Perl is well outside the scope of this document.
	Looking in the function list at
	\newline
	http://mileva.lite.msu.edu/loncapadocs/homework/homework5.html
	\newline
	can give you some ideas.
	O'Reilly has some good Perl books.
	The Perl 5 Pocket Reference will contain more than what you need to know
	to use LON-CAPA, available at
	\newline
	http://www.oreilly.com/catalog/perlpr3/ .
	\layout Standard

	If you have any problems, consult http://help.loncapa.org/fom/cache/5.html
	.
	If you don't find the answer to your problem, please help us expand the
	FAQ by submitting a new pending question.
	\layout Standard

	Our advanced users often come to prefer the XML interface for the problems,
	available through the
	\series bold
	EditXML
	\series default
	buttons.
	Covering the XML format is beyond the scope of this manual, but you can
	learn a lot by using the editor to make changes and seeing what happens
	to the XML.
	\layout Subsection

Formula Response	Formula Response
\begin_inset LatexCommand \index{Formula Response}	\begin_inset LatexCommand \index{Formula Response}
Line 3983 Formula Response	Line 4527 Formula Response
\end_inset	\end_inset

Problems	Problems
\layout Section	\layout Standard


	\begin_inset Float figure
	placement htbp
	wide false
	collapsed false

Additional Problem Components
\layout Standard	\layout Standard
	\align center

	\begin_inset Graphics FormatVersion 1
	filename formulaResponse.eps
	display color
	size_type 1
	width 80page%
	rotateOrigin center
	lyxsize_type 1
	lyxwidth 476pt
	lyxheight 262pt
	\end_inset

Using the
	\layout Caption

	Formula Response Problem
	\end_inset

	Formula response problems asks the student to type in a formula as an answer.
	If the answer is
	\begin_inset Formula $2x^{2}+4$
	\end_inset

	, the student is allowed to type
\begin_inset Quotes eld	\begin_inset Quotes eld
\end_inset	\end_inset

Insert	2xx+4
\begin_inset Quotes erd	\begin_inset Quotes erd
\end_inset	\end_inset

menu that appears in many of the problem editors, a wide variety of different	,
things can be added to the problems.	\begin_inset Quotes eld
\layout Section	\end_inset

Things That Need To Be Added	xx + xx + 4
\layout Subsection	\begin_inset Quotes erd
	\end_inset

LON-CAPA and Units	,
\layout Subsection	\begin_inset Quotes eld
	\end_inset

Creating a default metadata file	2*x^2 + 14 - 10
\layout Subsection	\begin_inset Quotes erd
	\end_inset

My questions\SpecialChar \ldots{}	, or any other equivalent expression.
	Formula Response problems have many of the same characteristics of Numerical
	Response problems, including the ability to run scripts, dynamically generate
	answers, etc.

	\layout Standard

\layout Itemize	As you may know, it is extremely difficult to determine whether a given
	expression is exactly equal to another expression in general.
	For example, is
	\begin_inset Formula $\sin 2x=2\sin x\cos x$
	\end_inset

How do I do the things above?	? Symbolically proving it one way or another is impossible in general.
\layout Itemize	Therefore, LON-CAPA uses a sampling system.
	If your answer and the student's answer agree at the sampling points within
	your given tolerance factor, the student's answer will be accepted, otherwise
	it will be rejected.
	\layout Subsubsection

Is there any pre-existing documentation for number or formula problems?	Sampling Specifications
\layout Itemize	\layout Standard

Is there any pre-existing documentation for maps et al? I seem to have exhausted	To specify where to sample the formulas for determining whether the student's
the documentation.	answer is correct, you need to put a sampling specification in the
\layout Itemize	\series bold
	Sample Points
	\series default

What is the LON-CAPA default resource? If it's free, can just anyone	\begin_inset LatexCommand \index{Sample Points}

	\end_inset

	field.
	The sampling specifications takes the following format:
	\layout Enumerate

	A comma separated list of the variables you wish to interpret,
	\layout Enumerate

	followed by
\begin_inset Quotes eld	\begin_inset Quotes eld
\end_inset	\end_inset

find and use it	@
\begin_inset Quotes erd	\begin_inset Quotes erd
\end_inset	\end_inset

, or just	(not in quotes),
	\layout Enumerate

	followed by any number of the following two things, separated by semi-colons:
	\begin_deeper
	\layout Enumerate

	a comma separated list of as many numbers as there are variables, which
	specifies one sampling point, OR
	\layout Enumerate

	a comma separated list of as many numbers as there are variables, followed
	by a colon, followed by another list of as many numbers as there are variables,
	followed by a #, followed by an integer.
	\end_deeper
	\layout Standard

	The first form specifies one point to sample.
	The second form specifies a range for each variable, and the system will
	take as many random samples from that range as the number after the #.
	\layout Standard

	For
	\begin_inset Formula $2x^{2}+4$
	\end_inset

	, with one variable
\begin_inset Quotes eld	\begin_inset Quotes eld
\end_inset	\end_inset

use it if they already know where it is	x
\begin_inset Quotes erd	\begin_inset Quotes erd
\end_inset	\end_inset

? (In other words, how powerful is the search feature?) What's the difference	, one could specify
between free and public?	\layout Itemize
\layout Section

Appendix A: Student Interface
\layout Standard

\begin_float fig	\begin_inset Quotes eld
\layout Caption	\end_inset

	x@2
	\begin_inset Quotes erd
	\end_inset

	, which will sample the answers only at 2.
	(This is generally a bad idea, as the student could get lucky and match
	at that point)
	\layout Itemize

Student Remote Control
\begin_inset LatexCommand \label{Student Remote Control}

	\begin_inset Quotes eld
\end_inset	\end_inset

	x@1:5#4
	\begin_inset Quotes erd
	\end_inset

\end_float	will takes 4 samples from somewhere between 1 and 5.
The Student Remote Control will automatically load whenever you log in to
a LON-CAPA course as a student.
The Student Remote Control contains most of the functions of the Author
Remote Control and the following additional functions.
\layout Itemize	\layout Itemize


\series bold	\begin_inset Quotes eld
NAV (NAVIGATE CONTENTS)	\end_inset
\series default
allows you to directly access resources from the course outline.
\layout Itemize

	x@1:5#4;10
	\begin_inset Quotes erd
	\end_inset

\series bold	will takes 4 samples from somewhere between 1 and 5, and also sample at
ARROWS (LEFT and RIGHT)	10.
\series default	\layout Standard
allows you to move to the backward or forward through the course.
	For
	\begin_inset Formula $2x^{2}+3y^{3}$
	\end_inset

	, which has two variables, one could specify
\layout Itemize	\layout Itemize


\series bold	\begin_inset Quotes eld
GRDS (MY GRADES)	\end_inset
\series default
allows you to check your grades in the courses you are taking.	x,y@4,5:10,12#4;0,0
	\begin_inset Quotes erd
	\end_inset

	, which take four samples from the box determined by the points (4, 5) and
	(10, 12), and also sample the point (0, 0).
	\layout Subsubsection

	Formula Notes
\layout Itemize	\layout Itemize

	The formula evaluator can not handle things of the form
	\begin_inset Quotes eld
	\end_inset

\series bold	x + - y
SBKM (SET BOOKMARK)	\begin_inset Quotes erd
\series default	\end_inset
allows you to bookmark pages for easy access.
	.
	If you have a random variable that may be positive or negative (as in the
	example following this section), you can try wrapping the references to
	that variable in parenthesis.
	As always, it is a good idea to try out several randomized versions of
	your problems to make sure everything works correctly.
\layout Itemize	\layout Itemize


\series bold	\series bold
VBKM (VIEW BOOKMARK)	Never use relative tolerance in Formula Response problems.
	\begin_inset LatexCommand \index{tolerance, in formula response}

	\end_inset


	\begin_inset LatexCommand \index{relative tolerance, in formula response}

	\end_inset


\series default	\series default
displays your bookmarks for easy access to bookmarked resources.	Relative tolerance is poorly defined in Formula Response problems.
\layout Itemize	Always use absolute tolerance.
	\layout Subsubsection

	Example Formula Response
	\layout Standard

	A very simple formula response problem:
	\layout Standard

	In the
\series bold	\series bold
ANOT (ANOTATE)	Script
\series default	\series default
allows you to create personal notes.	, place the following:
\layout Itemize	\layout LyX-Code

	$slope = &random(-5.0,5.0,.5);
	\layout LyX-Code

	$yint = &random(-5.0,5.0,.5);
	\layout LyX-Code

	$answer =
	\begin_inset Quotes eld
	\end_inset

	$slope*x + ($yint)
	\begin_inset Quotes erd
	\end_inset

	;
	\layout Itemize

	In the
\series bold	\series bold
LOGOUT (LOGOUT)	Text Block
\series default	\series default
will log you out of the LON-CAPA system.	, place the following:
\layout Standard	\begin_inset Quotes eld
	\end_inset

	For a line with slope $slope and y-intercept $yint, what is y equal to?
	\begin_inset Quotes erd
	\end_inset

\begin_inset LatexCommand \printindex{}

\end_inset	\layout Itemize

	In the
	\series bold
	Answer
	\series default
	, place the following: $answer
	\layout Itemize

	Set the Tolerance to .000001.
	\layout Itemize

	Set the
	\series bold
	Sample Points
	\series default
	to x@0,1,2,3 .
\the_end	\the_end

FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>

Removed from v.1.3
changed lines
	Added in v.1.8