version 1.1, 2002/05/29 16:44:43
|
version 1.3, 2002/06/03 05:15:59
|
Line 6
|
Line 6
|
\end_preamble |
\end_preamble |
\language english |
\language english |
\inputencoding auto |
\inputencoding auto |
\fontscheme newcent |
\fontscheme default |
\graphics default |
\graphics default |
\paperfontsize default |
\paperfontsize 12 |
\spacing single |
\spacing single |
\papersize Default |
\papersize Default |
\paperpackage a4 |
\paperpackage a4 |
\use_geometry 1 |
\use_geometry 1 |
\use_amsmath 0 |
\use_amsmath 0 |
\paperorientation portrait |
\paperorientation portrait |
\leftmargin 0.5in |
\leftmargin 1in |
\topmargin 1.25in |
\topmargin 1.25in |
\rightmargin 0.5in |
\rightmargin 1in |
\bottommargin 0.5in |
\bottommargin 1in |
\secnumdepth 3 |
\secnumdepth 3 |
\tocdepth 3 |
\tocdepth 3 |
\paragraph_separation indent |
\paragraph_separation indent |
Line 31
|
Line 31
|
|
|
\layout Title |
\layout Title |
|
|
Introduction to the Learning |
Learning |
\emph on |
\emph on |
Online |
Online |
\emph default |
\emph default |
Network with CAPA |
Network with CAPA |
|
\newline |
|
|
|
\emph on |
|
\SpecialChar ~ |
|
|
|
\newline |
|
|
|
\size larger |
|
Author's Tutorial And Manual |
|
\layout Standard |
|
\added_space_top vfill \align center |
|
\SpecialChar ~ |
|
|
\layout Standard |
\layout Standard |
\added_space_top vfill \pagebreak_bottom \align center |
\align center |
|
This manual was developed by John Williamson in the Office of Medical Education |
|
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 |
|
|
|
\SpecialChar ~ |
|
|
|
\layout Standard |
|
\pagebreak_bottom \align center |
Laboratory for Instructional Technology in Education |
Laboratory for Instructional Technology in Education |
\newline |
\newline |
and the |
and the |
Line 98 developed your objectives for your cours
|
Line 129 developed your objectives for your cours
|
\layout Itemize |
\layout Itemize |
|
|
developed your problems for testing and identified the question formats. |
developed your problems for testing and identified the question formats. |
The Template for Mapping Website to LON-CAPA that you filled in will assist |
\layout Subsection |
you in the process of creating your course website structure in LON-CAPA. |
|
|
About This Manual |
|
\layout Standard |
|
|
|
Throughout this manual, keywords and phrases literally present on the computer |
|
screen will be referred to in |
|
\series bold |
|
bold type |
|
\series default |
|
. |
|
\layout Standard |
|
|
|
Chapters |
|
\begin_inset LatexCommand \ref{Author Interface} |
|
|
|
\end_inset |
|
|
|
through |
|
\begin_inset LatexCommand \ref{Creating a Course} |
|
|
|
\end_inset |
|
|
|
comprise a tutorial that will introduce you to the authoring system. |
|
After that, this document is a reference manual for authoring course materials. |
\layout Standard |
\layout Standard |
|
|
This tutorial describes how to use the various author functions available |
For more information, see the website at http://help.loncapa.org/, where you |
in LON-CAPA. |
can get help and information. |
|
If you cannot find an answer for your question, please email us and let |
|
us know, so we put the solution to your problem online. |
\layout Section |
\layout Section |
|
|
The LON-CAPA Author Interface |
The LON-CAPA Author Interface |
|
\begin_inset LatexCommand \label{Author Interface} |
|
|
|
\end_inset |
|
|
|
|
\layout Subsection |
\layout Subsection |
|
|
Login as Course Author |
Login as Course Author |
Line 131 http://s10.lite.msu.edu/
|
Line 192 http://s10.lite.msu.edu/
|
. |
. |
|
|
\begin_float fig |
\begin_float fig |
\layout Caption |
|
|
|
|
|
\begin_inset LatexCommand \label{LON-CAPA Log in screen} |
|
|
|
\end_inset |
|
|
|
LON-CAPA Log in screen |
|
\layout Standard |
\layout Standard |
\align center |
\align center |
|
|
Line 150 flags 11
|
Line 203 flags 11
|
\end_inset |
\end_inset |
|
|
|
|
|
\layout Caption |
|
|
|
|
|
\begin_inset LatexCommand \label{LON-CAPA Log in screen} |
|
|
|
\end_inset |
|
|
|
LON-CAPA Log in screen |
\end_float |
\end_float |
\layout Standard |
\layout Standard |
|
|
Line 158 Fill in the Username and Password boxes
|
Line 219 Fill in the Username and Password boxes
|
This will take you to your LON-CAPA User Roles menu. |
This will take you to your LON-CAPA User Roles menu. |
\layout Description |
\layout Description |
|
|
Note: Your Username is your PILOT ID, which is the part of your PILOT email |
Note: Your Username and Password will be given to you by your system administrat |
address to the left of the @. |
or. |
Your password is your PILOT email password. |
Both are case sensitive, so make sure you type them with the correct case. |
Both the PILOT ID and the password are case sensitive, so make sure you |
|
type upper- and lower-case letters correctly. |
|
\layout Subsection |
\layout Subsection |
|
|
|
|
Line 290 ROLES
|
Line 349 ROLES
|
|
|
button takes up on my printout! So in actuality, you're commiting to something |
button takes up on my printout! So in actuality, you're commiting to something |
no sane remote control designer could deal with. |
no sane remote control designer could deal with. |
Moreover, I observe that on a real remote, the vast majority of buttons |
|
are labelled with one conceptual entity (i.e., |
|
\begin_inset Quotes eld |
|
\end_inset |
|
|
|
1 |
|
\begin_inset Quotes erd |
|
\end_inset |
|
|
|
, |
|
\begin_inset Quotes eld |
|
\end_inset |
|
|
|
5 |
|
\begin_inset Quotes erd |
|
\end_inset |
|
|
|
, |
|
\begin_inset Quotes eld |
|
\end_inset |
|
|
|
FF |
|
\begin_inset Quotes erd |
|
\end_inset |
|
|
|
, |
|
\begin_inset Quotes eld |
|
\end_inset |
|
|
|
[the pause symbol] |
|
\begin_inset Quotes erd |
|
\end_inset |
|
|
|
, etc)., not |
|
\begin_inset Quotes eld |
|
\end_inset |
|
|
|
Change User |
|
\begin_inset Quotes erd |
|
\end_inset |
|
|
|
which is two entities by my count, at least for an initial user. |
|
\layout Comment |
\layout Comment |
|
|
\SpecialChar ~ |
\SpecialChar ~ |
Line 367 The upshot is that the only upside to th
|
Line 384 The upshot is that the only upside to th
|
|
|
\layout Comment |
\layout Comment |
|
|
Also, based on my relatively little info, I think you're data-mining the |
We're data-mining the web logs to see what people actually use. |
web logs to see what people actually use. |
|
This is good. |
This is good. |
We may need to do some really simple stuff before he finishes. |
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 |
Raw statistics on what buttons are pressed most often can probably be interpret |
Line 392 The Author Remote Control, show in figur
|
Line 408 The Author Remote Control, show in figur
|
may position it on the screen where you can make the best use of it. |
may position it on the screen where you can make the best use of it. |
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_float fig |
\layout Caption |
\layout Standard |
|
\align center |
|
|
Author Remote Control |
\begin_inset Figure size 177 420 |
\begin_inset LatexCommand \label{Author Remote Control Figure} |
file authorRemote.eps |
|
height 3 50 |
|
flags 9 |
|
|
\end_inset |
\end_inset |
|
|
|
|
\layout Standard |
\layout Caption |
|
|
|
|
\begin_inset Figure size 164 387 |
Author Remote Control |
file authorRemote.eps |
\begin_inset LatexCommand \label{Author Remote Control Figure} |
flags 8 |
|
|
|
\end_inset |
\end_inset |
|
|
|
|
\end_float |
\end_float |
|
\layout Comment |
|
|
Of the eight choices on this menu, only two (ROLES and LOGOUT) make *any* |
Of the eight choices on this menu, only two (ROLES and LOGOUT) make *any* |
sort of sense on a first glance. |
sort of sense on a first glance. |
Abbreviations are evil in this sort of application and should be used as |
Abbreviations are evil in this sort of application and should be used as |
Line 499 Content Page
|
Line 519 Content Page
|
\end_inset |
\end_inset |
|
|
displays course content. |
displays course content. |
It is mostly a conventional HTML page. |
It is essentially a conventional HTML page. |
|
|
\layout Comment |
\layout Comment |
|
|
Line 547 Sequence
|
Line 567 Sequence
|
|
|
\series default |
\series default |
type represents a programmed series of events. |
type represents a programmed series of events. |
The users of this resource can use array keys or NAV buttons to follow |
The users of this resource can use buttons on their remote or the NAV button |
the sequence. |
to follow the sequence. |
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 |
\end_inset |
\end_inset |
Line 607 Description of the Construction Space
|
Line 627 Description of the Construction Space
|
\layout Standard |
\layout Standard |
|
|
\begin_float fig |
\begin_float fig |
|
\layout Standard |
|
\align center |
|
|
|
\begin_inset Figure size 476 42 |
|
file constructionSpace.eps |
|
width 3 80 |
|
flags 9 |
|
|
|
\end_inset |
|
|
|
|
\layout Caption |
\layout Caption |
|
|
Construction Space |
Construction Space |
Line 668 Publish this Resource
|
Line 699 Publish this Resource
|
|
|
\layout Standard |
\layout Standard |
|
|
Publishes the current resource. |
Opens the Resource Publishing window. |
This presents a publishing window where you can provide information for |
|
metadata, keywords, language, etc. |
|
\end_inset |
\end_inset |
</cell> |
</cell> |
</row> |
</row> |
Line 724 Browse
|
Line 753 Browse
|
|
|
\layout Standard |
\layout Standard |
|
|
Opens a file/directory browser for your local computer. |
Helps you select a file to upload |
Use this to select a file to upload. |
|
\end_inset |
\end_inset |
</cell> |
</cell> |
</row> |
</row> |
Line 827 Type a name in the entry box to create a
|
Line 855 Type a name in the entry box to create a
|
\layout Subsection |
\layout Subsection |
|
|
How to Create New Content Pages |
How to Create New Content Pages |
|
\begin_inset LatexCommand \label{Creating New Content Pages} |
|
|
|
\end_inset |
|
|
|
|
\layout Standard |
\layout Standard |
|
|
|
|
Line 834 How to Create New Content Pages
|
Line 867 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. |
These documents can be created in any order. |
To create new Content Pages, do the following: |
\layout Comment |
|
|
|
Is this worth mentioning? |
|
\layout Standard |
|
|
|
To create new Content Pages, do the following: |
|
\layout Comment |
\layout Comment |
|
|
Is step one necessary? I don't see how it could be. |
Is step one necessary? I don't see how it could be. |
Line 865 In Location bar of your browser, type in
|
Line 892 In Location bar of your browser, type in
|
|
|
, for example, |
, for example, |
\emph on |
\emph on |
http://www.s10.lite.msu.edu/priv/directory/new_resource.html |
http://www.s10.lite.msu.edu/priv/\SpecialChar \- |
|
directory/new_resource.html |
\emph default |
\emph default |
. |
. |
Press the Return or Enter key. |
Press the Return or Enter key. |
Line 873 http://www.s10.lite.msu.edu/priv/directo
|
Line 901 http://www.s10.lite.msu.edu/priv/directo
|
|
|
You should see something like the following message: |
You should see something like the following message: |
\series bold |
\series bold |
File not found: /home/wmsonj/priv/directory/new_resource.html |
File not found: /home/wmsonj/priv/\SpecialChar \- |
|
directory/new_resource.html |
\series default |
\series default |
, and an Edit button. |
, and an Edit button. |
An HTML editor opens with a simple page template. |
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, |
\series bold |
\emph on |
OR |
OR |
\series default |
\emph default |
copy and paste HTML source code into the editor. |
copy and paste HTML source code into the editor. |
\layout Enumerate |
\layout Enumerate |
|
|
Line 898 Finally, click the
|
Line 935 Finally, click the
|
Save this |
Save this |
\series default |
\series default |
button |
button |
\series bold |
\emph on |
OR |
OR |
\series default |
\emph default |
click the |
click the |
\series bold |
\series bold |
Save and then attempt to clean HTML |
Save and then attempt to clean HTML |
Line 909 Save and then attempt to clean HTML
|
Line 946 Save and then attempt to clean HTML
|
\layout Standard |
\layout Standard |
|
|
Repeat this process as many times as necessary to create your Content Pages. |
Repeat this process as many times as necessary to create your Content Pages. |
|
|
|
\layout Standard |
|
|
|
If you're following this as a tutorial, create at least one content page, |
|
which we'll use later as raw material. |
\layout Subsection |
\layout Subsection |
|
|
How to Edit Existing Content Pages |
How to Edit Existing Content Pages |
Line 949 Finally, click the
|
Line 991 Finally, click the
|
Save this |
Save this |
\series default |
\series default |
button |
button |
\series bold |
\emph on |
OR |
OR |
\series default |
\emph default |
click the |
click the |
\series bold |
\series bold |
Save and then attempt to clean HTML |
Save and then attempt to clean HTML |
Line 961 Save and then attempt to clean HTML
|
Line 1003 Save and then attempt to clean HTML
|
\layout Subsection |
\layout Subsection |
|
|
Creating Online Problems Using LON-CAPA |
Creating Online Problems Using LON-CAPA |
|
\layout Standard |
|
|
|
If you're following this as a tutorial, go ahead and make one of each of |
|
these problem types now. |
|
We'll be using them later as raw material to assemble maps and sequences. |
\layout Subsubsection |
\layout Subsubsection |
|
|
Problems Types |
Problems Types |
Line 973 There are five types of problems that ca
|
Line 1020 There are five types of problems that ca
|
appropriate questions for your course. |
appropriate questions for your course. |
\layout Subsubsection |
\layout Subsubsection |
|
|
|
Foils |
|
\layout Standard |
|
|
|
In the LON-CAPA system, a |
|
\series bold |
|
Foil |
|
\begin_inset LatexCommand \index{Foil} |
|
|
|
\end_inset |
|
|
|
|
|
\series default |
|
is a choice in a Radio Response or Option Response problem. |
|
For instance, True/False problems have two foils, one for True, and one |
|
for False. |
|
Foils do not need to be text; they can be images or other resources. |
|
\layout Subsubsection |
|
|
Radio Response |
Radio Response |
\begin_inset LatexCommand \index{Radio Response} |
\begin_inset LatexCommand \index{Radio Response} |
|
|
Line 981 Radio Response
|
Line 1046 Radio Response
|
Problems |
Problems |
\layout Standard |
\layout Standard |
|
|
Radio Response problems represent multiple choice questions. |
|
\layout Standard |
|
|
|
True/False problems present the student with one question that can be answered |
\series bold |
true or false. |
Radio Response |
|
\series default |
|
problems represent multiple choice questions. |
|
A True/False problem is a special case of Radio Response problem with two |
|
foils, True or False. |
\layout Standard |
\layout Standard |
|
|
Multiple choice problems are created almost identically to True/False problems. |
Multiple choice problems contain between 3 and 10 foils. |
Multiple choice problems contain 3-10 foils. |
You may display from three to five foils for each problem and the system |
You may display 3-5 foils for each problem and the system randomly picks |
randomly picks the choices that are presented to the student. |
the choices that are presented to the student. |
\layout Comment |
\layout Standard |
|
|
Eh? If this means what I think it means, clarify. |
|
Is the system really incapable of showing eight choices all at once? |
|
\layout Subsubsection |
|
|
Option Response Problems |
Option Response |
|
\begin_inset LatexCommand \index{Option Response} |
|
|
|
\end_inset |
|
|
|
Problems |
\layout Standard |
\layout Standard |
|
|
Option Response problems present foils to the student with drop-down boxes. |
Option Response problems present foils to the student with drop-down boxes. |
Option response questions may be presented as a collection of True/False |
A group of foils is created for each concept group, and the system will |
type questions or as a matching type question. |
pick one to present to the student from each group. |
The student must choose the correct answer for each part of the question. |
The student must match each of his or her questions correctly to the possible |
\layout Standard |
answers before receiving credit for the problem. |
|
For more details, see the Create Option Response ( |
|
\begin_inset LatexCommand \ref{Create Option Response Problem} |
|
|
|
\end_inset |
|
|
|
). |
|
\layout Subsubsection |
|
|
String Response Problems |
String Response Problems |
\layout Standard |
\layout Standard |
|
|
String Response problems are problems in which the student submits a string |
|
of characters for the answer. |
\series bold |
|
|
|
\begin_inset LatexCommand \index{String Response} |
|
|
|
\end_inset |
|
|
|
String Response |
|
\series default |
|
problems are problems in which the student submits a string of characters |
|
for the answer. |
Examples of string response questions are vocabulary tests, short answer |
Examples of string response questions are vocabulary tests, short answer |
and entering chemical formulas. |
and entering chemical formulas. |
\layout Standard |
\layout Standard |
|
|
|
Note that it is easy to abuse String Response problems. |
|
For instance, consider the question |
|
\begin_inset Quotes eld |
|
\end_inset |
|
|
|
Who wrote 'Huckleberry Finn'? |
|
\begin_inset Quotes erd |
|
\end_inset |
|
|
|
If you tell the system the answer is |
|
\begin_inset Quotes eld |
|
\end_inset |
|
|
|
Mark Twain |
|
\begin_inset Quotes erd |
|
\end_inset |
|
|
|
, and a student answers |
|
\begin_inset Quotes eld |
|
\end_inset |
|
|
|
Twain |
|
\begin_inset Quotes erd |
|
\end_inset |
|
|
|
, the system will mark it wrong. |
|
If they answer |
|
\begin_inset Quotes eld |
|
\end_inset |
|
|
|
Samuel Clements |
|
\begin_inset Quotes erd |
|
\end_inset |
|
|
|
, then the student will definately get it wrong. |
|
There is some room for flexibility in the string processing, but it can |
|
be difficult to get it all right. |
|
Before you use a String Response problem, be sure you can easily characterize |
|
correct answers. |
|
\layout Subsubsection |
|
|
Numerical Response Problems |
Numerical Response Problems |
\layout Standard |
\layout Standard |
|
|
Numerical Response problems are answered by entering a number and (optionally) |
|
a unit, such as 2.5 m/s^2. |
\series bold |
|
Numerical Response |
|
\begin_inset LatexCommand \index{Numerical Response} |
|
|
|
\end_inset |
|
|
|
|
|
\series default |
|
problems are answered by entering a number and (optionally) a unit, such |
|
as 2.5 m/s^2. |
Tolerance and significant digits can be specified as well. |
Tolerance and significant digits can be specified as well. |
\layout Standard |
\layout Subsubsection |
|
|
Formula Response Problems |
Formula Response Problems |
\layout Standard |
\layout Standard |
|
|
Formula Response problems are questions in which the student types in a |
Formula Response problems are questions in which the student types in a |
math formula for the answer. |
math formula for the answer. |
If the answer is "x^2 - 11", the student can enter "x^2 - 11", "x*x - 11", |
If the answer is |
"x^2 + 21 - 10", etc. |
\begin_inset Formula \( x^{2}-11 \) |
|
\end_inset |
|
|
|
, the student can enter "x^2 - 11", "x*x - 11", "x^2 + 21 - 10", etc. |
Functions such as cos, sin, and exp are accepted as well as the operators |
Functions such as cos, sin, and exp are accepted as well as the operators |
(), +, -, *, and /. |
(), +, -, *, and /. |
|
\layout Subsection |
|
|
|
Creating Radio Response Problems |
|
\layout Standard |
|
|
|
\begin_float fig |
|
\layout Standard |
|
\align center |
|
|
|
\begin_inset Figure size 476 201 |
|
file creatingNewProblemResource.eps |
|
width 3 80 |
|
flags 13 |
|
|
|
\end_inset |
|
|
|
|
|
\layout Caption |
|
|
|
Creating A New Problem Resource |
|
\begin_inset LatexCommand \label{Creating a new problem resource} |
|
|
|
\end_inset |
|
|
|
|
|
\end_float |
|
To create an Radio Response |
|
\begin_inset LatexCommand \index{Radio Response} |
|
|
|
\end_inset |
|
|
|
problem, create a new resource as described in section |
|
\begin_inset LatexCommand \ref{Creating New Content Pages} |
|
|
|
\end_inset |
|
|
|
. |
|
This is a |
|
\begin_inset Quotes eld |
|
\end_inset |
|
|
|
problem |
|
\begin_inset Quotes erd |
|
\end_inset |
|
|
|
resource so the URL must end in |
|
\begin_inset Quotes eld |
|
\end_inset |
|
|
|
.problem |
|
\begin_inset Quotes erd |
|
\end_inset |
|
|
|
. |
|
You should see a screen as in figure |
|
\begin_inset LatexCommand \ref{Creating a new problem resource} |
|
|
|
\end_inset |
|
|
|
. |
|
\begin_float fig |
|
\layout Standard |
|
\align center |
|
|
|
\begin_inset Figure size 476 283 |
|
file radioResponse2.eps |
|
width 3 80 |
|
flags 9 |
|
|
|
\end_inset |
|
|
|
|
|
\layout Caption |
|
|
|
Radio Response Creation Form |
|
\begin_inset LatexCommand \label{Radio Response Creation Form} |
|
|
|
\end_inset |
|
|
|
|
|
\end_float |
|
You will need to create the posible answers and the questions. |
|
\layout Enumerate |
|
|
|
In the drop-down option box as seen in |
|
\begin_inset LatexCommand \ref{Creating a new problem resource} |
|
|
|
\end_inset |
|
|
|
, select |
|
\series bold |
|
Radio Response Problem |
|
\series default |
|
, and click the |
|
\series bold |
|
New Problem |
|
\series default |
|
button. |
|
\layout Enumerate |
|
|
|
Click the |
|
\series bold |
|
Edit |
|
\series default |
|
button above the sample problem to enter edit mode. |
|
\layout Enumerate |
|
|
|
In the |
|
\series bold |
|
Text Block |
|
\series default |
|
at the top of the problem, remove the sample text and type the question |
|
for your problem. |
|
For example, |
|
\begin_inset Quotes eld |
|
\end_inset |
|
|
|
What is two plus two? |
|
\begin_inset Quotes erd |
|
\end_inset |
|
|
|
|
|
\layout Enumerate |
|
|
|
Locate the |
|
\series bold |
|
Response: One of N statements |
|
\series default |
|
element. |
|
In the |
|
\series bold |
|
Max Number of Shown Foils |
|
\series default |
|
text box, place the number of wrong answers you wish to supply to each |
|
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 |
|
|
|
Locate |
|
\series bold |
|
Foil 1 |
|
\series default |
|
. |
|
Remove the text that is in the text box and put the |
|
\emph on |
|
correct answer |
|
\emph default |
|
for the problem in the |
|
\series bold |
|
Text Block |
|
\series default |
|
. |
|
For example, |
|
\begin_inset Quotes eld |
|
\end_inset |
|
|
|
Four. |
|
\begin_inset Quotes erd |
|
\end_inset |
|
|
|
|
|
\layout Enumerate |
|
|
|
Below it, you will see |
|
\series bold |
|
Foil 2 |
|
\series default |
|
. |
|
Remove the text in the text box and put an |
|
\emph on |
|
incorrect answer |
|
\emph default |
|
for the problem. |
|
For instance, |
|
\begin_inset Quotes eld |
|
\end_inset |
|
|
|
Purple. |
|
\begin_inset Quotes erd |
|
\end_inset |
|
|
|
|
|
\layout Enumerate |
|
|
|
Repeat the previous step until you've filled in all of the other incorrect |
|
answers you wish to offer the students. |
|
\layout Enumerate |
|
|
|
Once you've filled in all the incorrect answers, change the |
|
\series bold |
|
Correct Option |
|
\series default |
|
s on the other foils to |
|
\series bold |
|
Unused |
|
\series default |
|
. |
|
\layout Enumerate |
|
|
|
\begin_float fig |
|
\layout Standard |
|
\align center |
|
|
|
\begin_inset Figure size 476 92 |
|
file radioResponseHint.eps |
|
width 3 80 |
|
flags 9 |
|
|
|
\end_inset |
|
|
|
|
|
\layout Caption |
|
|
|
Hint Element |
|
\begin_inset LatexCommand \label{Radio Response Hint Element Figure} |
|
|
|
\end_inset |
|
|
|
|
|
\end_float |
|
Scroll down to the Hint element, as shown in Figure |
|
\begin_inset LatexCommand \ref{Radio Response Hint Element Figure} |
|
|
|
\end_inset |
|
|
|
. |
|
Type some text that will help students when they answer incorrectly. |
|
\layout Enumerate |
|
|
|
Click the |
|
\series bold |
|
Submit Changes |
|
\series default |
|
button located at the top of the frame. |
|
If you do not do this, none of your changes will be saved. |
|
\layout Standard |
|
|
|
The |
|
\series bold |
|
Correct Option |
|
\series default |
|
drop down box controls whether or not a given answer will be accepted as |
|
a correct answer. |
|
If it is set to |
|
\series bold |
|
true |
|
\series default |
|
, that answer will be considered a correct answer. |
|
Any number of foils can be marked |
|
\series bold |
|
true |
|
\series default |
|
, so you can have questions with multiple correct answers. |
|
If it is set to |
|
\series bold |
|
false |
|
\series default |
|
, it will be considered an incorrect answer. |
|
If it is set to |
|
\series bold |
|
Unused |
|
\series default |
|
, the system will not use that foil. |
|
\layout Paragraph |
|
|
|
Randomization |
|
\begin_inset LatexCommand \index{Randomization} |
|
|
|
\end_inset |
|
|
|
|
|
\layout Standard |
|
|
|
LON-CAPA will randomize what choices are presented to each student, and |
|
randomize the order they are presented in. |
|
If you wish to present each student the same choices, make sure the |
|
\series bold |
|
Maximum Number of Shown Foils |
|
\series default |
|
box contains the number of incorrect answers, which will force them to |
|
all be displayed. |
|
If you wish to force the system to display the foils in the order you have |
|
created them in, type the HTML tag |
|
\series bold |
|
<norandom> |
|
\series default |
|
into your problem text. |
|
This can be useful with the ever-popular |
|
\begin_inset Quotes eld |
|
\end_inset |
|
|
|
All of the above |
|
\begin_inset Quotes erd |
|
\end_inset |
|
|
|
choice, which must be displayed in the correct place or its meaning will |
|
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 |
|
|
|
Option Response |
|
\begin_inset LatexCommand \index{Option Response} |
|
|
|
\end_inset |
|
|
|
|
|
\begin_inset LatexCommand \label{Create Option Response Problem} |
|
|
|
\end_inset |
|
|
|
Problems |
|
\layout Standard |
|
|
|
\begin_float fig |
|
\layout Standard |
|
\align center |
|
|
|
\begin_inset Figure size 476 280 |
|
file optionResponseProblem.eps |
|
width 3 80 |
|
flags 9 |
|
|
|
\end_inset |
|
|
|
|
|
\layout Caption |
|
|
|
Option Response Problem |
|
\begin_inset LatexCommand \label{Option Response Problem Figure} |
|
|
|
\end_inset |
|
|
|
|
|
\end_float |
|
Each Option Response problem has three parts: |
|
\layout Enumerate |
|
|
|
The Concept Groups |
|
\begin_inset LatexCommand \index{Concept Groups} |
|
|
|
\end_inset |
|
|
|
|
|
\layout Enumerate |
|
|
|
The options for the students to select, by default |
|
\begin_inset Quotes eld |
|
\end_inset |
|
|
|
True |
|
\begin_inset Quotes erd |
|
\end_inset |
|
|
|
and |
|
\begin_inset Quotes eld |
|
\end_inset |
|
|
|
False |
|
\begin_inset Quotes erd |
|
\end_inset |
|
|
|
|
|
\layout Enumerate |
|
|
|
The hint for the student |
|
\layout Standard |
|
|
|
Each |
|
\series bold |
|
Concept Group |
|
\series default |
|
has some number of foils representing questions which are conceptually |
|
related. |
|
Option Response Problems can have between 4 and 8 Concept Groups in a problem. |
|
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 |
|
it to the student. |
|
In order to receive credit for the problem, the student must answer all |
|
of the Concept Group foils correctly. |
|
\layout Subsubsection |
|
|
|
Example: Concept Group |
|
\layout Standard |
|
|
|
For example, a Concept Group may contain the following True/False questions: |
|
\layout Itemize |
|
|
|
|
|
\begin_inset Quotes eld |
|
\end_inset |
|
|
|
Mark Twain |
|
\begin_inset Quotes erd |
|
\end_inset |
|
|
|
is the pen name of Samuel Clemens. |
|
\layout Itemize |
|
|
|
Mark Twain wrote |
|
\begin_inset Quotes eld |
|
\end_inset |
|
|
|
The Call of the Wild |
|
\begin_inset Quotes erd |
|
\end_inset |
|
|
|
. |
|
\layout Itemize |
|
|
|
Mark Twain wrote |
|
\begin_inset Quotes eld |
|
\end_inset |
|
|
|
Huckleberry Finn |
|
\begin_inset Quotes erd |
|
\end_inset |
|
|
|
. |
|
\layout Itemize |
|
|
|
Mark Twain spent most of his life in the Congo. |
|
\layout Standard |
|
|
|
For each foil, the author marks it True or False. |
|
When the student logs on and attempts to answer this question, the student |
|
will see only one of the four choices for that concept group. |
|
They then go on to do the remaining three to seven Concept Groups in this |
|
question before submitting their answer. |
|
\layout Subsubsection |
|
|
|
Example: Matching Problem |
|
\layout Standard |
|
|
|
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 |
|
place the following four things each in their own concept group: |
|
\layout Itemize |
|
|
|
Claire de Lune |
|
\begin_inset LatexCommand \index{Clair de Lune} |
|
|
|
\end_inset |
|
|
|
|
|
\begin_float footnote |
|
\layout Standard |
|
|
|
Debussy. |
|
\end_float |
|
\layout Itemize |
|
|
|
The Pastoral Symphony |
|
\begin_float footnote |
|
\layout Standard |
|
|
|
Beethoven's Sixth Symphony. |
|
\end_float |
|
\layout Itemize |
|
|
|
Sleeping Beauty Suite |
|
\begin_float footnote |
|
\layout Standard |
|
|
|
Tchaikovsky. |
|
\end_float |
|
\layout Itemize |
|
|
|
The Dance of the Sugar Plum Fairies |
|
\begin_float footnote |
|
\layout Standard |
|
|
|
Also Tchaikovsky, from The Nutcracker. |
|
\end_float |
|
\layout Standard |
|
|
|
You could then add the following options to the option list: |
|
\layout Itemize |
|
|
|
Debussy |
|
\layout Itemize |
|
|
|
Beethoven |
|
\layout Itemize |
|
|
|
Schubert |
|
\layout Itemize |
|
|
|
Tchaikovsky |
|
\layout Itemize |
|
|
|
Bach |
|
\layout Standard |
|
|
|
The same answers can be used more then once, or not at all, as you see fit. |
|
It is conventional to place such a warning in the |
|
\series bold |
|
Text Block |
|
\series default |
|
describing the problem to the students. |
|
\layout Subsubsection |
|
|
|
Creating Option Response Problems |
|
\layout Standard |
|
|
|
To create an Option Response problem, create a new resource as described |
|
in section |
|
\begin_inset LatexCommand \ref{Creating New Content Pages} |
|
|
|
\end_inset |
|
|
|
. |
|
This is a |
|
\begin_inset Quotes eld |
|
\end_inset |
|
|
|
problem |
|
\begin_inset Quotes erd |
|
\end_inset |
|
|
|
resource so the URL must end in |
|
\begin_inset Quotes eld |
|
\end_inset |
|
|
|
.problem |
|
\begin_inset Quotes erd |
|
\end_inset |
|
|
|
. |
|
You should see a screen as in figure |
|
\begin_inset LatexCommand \ref{Creating a new problem resource} |
|
|
|
\end_inset |
|
|
|
. |
|
\layout Enumerate |
|
|
|
In the drop-down option box as seen in |
|
\begin_inset LatexCommand \ref{Creating a new problem resource} |
|
|
|
\end_inset |
|
|
|
, select |
|
\series bold |
|
Option Response Problem with |
|
\emph on |
|
N |
|
\emph default |
|
Concept Groups |
|
\series default |
|
, where |
|
\series bold |
|
\emph on |
|
N |
|
\series default |
|
\emph default |
|
is the number of Concept Groups you wish the problem to have, and click |
|
the |
|
\series bold |
|
New Problem |
|
\series default |
|
button. |
|
\layout Enumerate |
|
|
|
Click the |
|
\series bold |
|
Edit |
|
\series default |
|
button above the sample problem to enter edit mode. |
|
\begin_float fig |
|
\layout Standard |
|
\align center |
|
|
|
\begin_inset Figure size 476 276 |
|
file optionResponseEditing.eps |
|
width 3 80 |
|
flags 9 |
|
|
|
\end_inset |
|
|
|
|
|
\layout Caption |
|
|
|
Option Response Editor |
|
\begin_inset LatexCommand \label{Option Response Editor Figure} |
|
|
|
\end_inset |
|
|
|
|
|
\end_float |
|
You should see the Option Response page open up, which should look something |
|
like what you see in figure |
|
\begin_inset LatexCommand \ref{Option Response Editor Figure} |
|
|
|
\end_inset |
|
|
|
. |
|
\layout Enumerate |
|
|
|
Replace the text in the |
|
\series bold |
|
Text Block |
|
\series default |
|
with text that explains the conditions for your problem. |
|
\layout Enumerate |
|
|
|
Locate the |
|
\series bold |
|
Max Number of Shown Foils |
|
\series default |
|
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 |
|
option will only reduce the number of foils displayed, if it is less then |
|
the number of concept groups in your Option Response problem. |
|
\layout Enumerate |
|
|
|
Now you must define the options the students can select. |
|
For each option you wish to add to the Option Response question, type the |
|
option into the |
|
\series bold |
|
Add new Option |
|
\series default |
|
box in the |
|
\series bold |
|
Select Options |
|
\series default |
|
section, then hit the |
|
\series bold |
|
Save Changes |
|
\series default |
|
button. |
|
If you do not hit the |
|
\series bold |
|
Save Changes |
|
\series default |
|
button, your option will not be selectable below. |
|
\layout Enumerate |
|
|
|
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 |
|
|
|
Now, you need to define the question foils. |
|
Look for the foil with the name |
|
\begin_inset Quotes eld |
|
\end_inset |
|
|
|
One |
|
\begin_inset Quotes erd |
|
\end_inset |
|
|
|
. |
|
Type the question into the text box, and select the correct option for |
|
that question from the |
|
\series bold |
|
Correct Option |
|
\series default |
|
drop-down menu. |
|
Click |
|
\series bold |
|
Submit Changes |
|
\series default |
|
to save this question foil. |
|
Repeat this step for all remaining foils. |
|
\layout Enumerate |
|
|
|
Locate the foils that are not being used. |
|
In their |
|
\series bold |
|
Delete |
|
\series default |
|
menus, set the value to |
|
\series bold |
|
Yes |
|
\series default |
|
. |
|
Once you've set the Delete menu value correctly for all the foils, click |
|
the |
|
\series bold |
|
Save Changes |
|
\series default |
|
button. |
|
\layout Enumerate |
|
|
|
In the Hint area, provide a helpful hint for users who get the problem incorrect |
|
, and click the |
|
\series bold |
|
Save Changes |
|
\series default |
|
button. |
|
\layout Subsection |
|
|
|
Creating a String Response Problem |
|
\layout Standard |
|
|
|
To create an String Response problem, create a new resource as described |
|
in section |
|
\begin_inset LatexCommand \ref{Creating New Content Pages} |
|
|
|
\end_inset |
|
|
|
. |
|
This is a |
|
\begin_inset Quotes eld |
|
\end_inset |
|
|
|
problem |
|
\begin_inset Quotes erd |
|
\end_inset |
|
|
|
resource so the URL must end in |
|
\begin_inset Quotes eld |
|
\end_inset |
|
|
|
.problem |
|
\begin_inset Quotes erd |
|
\end_inset |
|
|
|
. |
|
You should see a screen as in figure |
|
\begin_inset LatexCommand \ref{Creating a new problem resource} |
|
|
|
\end_inset |
|
|
|
. |
|
\layout Enumerate |
|
|
|
In the drop-down option box as seen in |
|
\begin_inset LatexCommand \ref{Creating a new problem resource} |
|
|
|
\end_inset |
|
|
|
, select |
|
\series bold |
|
Simple String Response Problem |
|
\series default |
|
, and click the |
|
\series bold |
|
New Problem |
|
\series default |
|
button. |
|
\layout Enumerate |
|
|
|
Click the |
|
\series bold |
|
Edit |
|
\series default |
|
button above the sample problem to enter edit mode. |
|
\begin_float fig |
|
\layout Standard |
|
\align center |
|
|
|
\begin_inset Figure size 476 320 |
|
file stringResponseEditor.eps |
|
width 3 80 |
|
flags 9 |
|
|
|
\end_inset |
|
|
|
|
|
\layout Caption |
|
|
|
String Response Editor |
|
\begin_inset LatexCommand \label{String Response Editor Figure} |
|
|
|
\end_inset |
|
|
|
|
|
\end_float |
|
You should see the String Response editor page open up, which should look |
|
something like what you see in figure |
|
\begin_inset LatexCommand \ref{String Response Editor Figure} |
|
|
|
\end_inset |
|
|
|
. |
|
\layout Enumerate |
|
|
|
Clear the text from the Text Block at the top of the problem, and type in |
|
your problem's question. |
|
\layout Enumerate |
|
|
|
In the |
|
\series bold |
|
Answer Box |
|
\series default |
|
, type the correct answer. |
|
\layout Enumerate |
|
|
|
Select the answer condition from the drop down box. |
|
There are three cases to choose from: |
|
\begin_deeper |
|
\layout Enumerate |
|
|
|
|
|
\series bold |
|
cs |
|
\series default |
|
: This means |
|
\begin_inset Quotes eld |
|
\end_inset |
|
|
|
Case Sensitive |
|
\begin_inset Quotes erd |
|
\end_inset |
|
|
|
. |
|
For example, this is useful in Chemistry, where HO and Ho are completely |
|
different answers |
|
\begin_float footnote |
|
\end_deeper |
|
\layout Standard |
|
|
|
|
|
\series bold |
|
HO |
|
\series default |
|
is hydrogen monoxide, a colorless, odorless, poisonous gas. |
|
|
|
\series bold |
|
Ho |
|
\series default |
|
is the element 67, Holmium, in the Lanthanides. |
|
\end_float |
|
. |
|
The student must match the case of the answer. |
|
\begin_deeper |
|
\layout Enumerate |
|
|
|
|
|
\series bold |
|
ci |
|
\series default |
|
: This means |
|
\begin_inset Quotes eld |
|
\end_inset |
|
|
|
Case Insenstive |
|
\begin_inset Quotes erd |
|
\end_inset |
|
|
|
. |
|
The system does not use the case of the letters to determine the correctness |
|
of the answer. |
|
If the correct answer is |
|
\begin_inset Quotes eld |
|
\end_inset |
|
|
|
car |
|
\begin_inset Quotes erd |
|
\end_inset |
|
|
|
, the system will accept |
|
\begin_inset Quotes eld |
|
\end_inset |
|
|
|
car |
|
\begin_inset Quotes erd |
|
\end_inset |
|
|
|
, |
|
\begin_inset Quotes eld |
|
\end_inset |
|
|
|
CAR |
|
\begin_inset Quotes erd |
|
\end_inset |
|
|
|
, |
|
\begin_inset Quotes eld |
|
\end_inset |
|
|
|
Car |
|
\begin_inset Quotes erd |
|
\end_inset |
|
|
|
, |
|
\begin_inset Quotes eld |
|
\end_inset |
|
|
|
caR |
|
\begin_inset Quotes erd |
|
\end_inset |
|
|
|
, etc. |
|
\layout Enumerate |
|
|
|
|
|
\series bold |
|
mc |
|
\series default |
|
: This means |
|
\begin_inset Quotes eld |
|
\end_inset |
|
|
|
Multiple Choice |
|
\begin_inset Quotes erd |
|
\end_inset |
|
|
|
. |
|
The student's answers must contain the same letters as the question author's, |
|
but order is unimportent. |
|
This is usually used to give a multiple choice question in the question's |
|
|
|
\series bold |
|
Text Block |
|
\series default |
|
, which may have several correct parts. |
|
If the author sets the correct answer as |
|
\begin_inset Quotes eld |
|
\end_inset |
|
|
|
bcg |
|
\begin_inset Quotes erd |
|
\end_inset |
|
|
|
, the system will accept |
|
\begin_inset Quotes eld |
|
\end_inset |
|
|
|
bcg |
|
\begin_inset Quotes erd |
|
\end_inset |
|
|
|
, |
|
\begin_inset Quotes eld |
|
\end_inset |
|
|
|
cbg |
|
\begin_inset Quotes erd |
|
\end_inset |
|
|
|
, |
|
\begin_inset Quotes eld |
|
\end_inset |
|
|
|
gcb |
|
\begin_inset Quotes erd |
|
\end_inset |
|
|
|
, etc., but not |
|
\begin_inset Quotes eld |
|
\end_inset |
|
|
|
bc |
|
\begin_inset Quotes erd |
|
\end_inset |
|
|
|
or |
|
\begin_inset Quotes eld |
|
\end_inset |
|
|
|
abcg |
|
\begin_inset Quotes erd |
|
\end_inset |
|
|
|
. |
|
\layout Standard |
|
|
|
It is conventional to tell the students whether the question is case sensitive |
|
or not. |
|
\end_deeper |
|
\layout Enumerate |
|
|
|
Optionally, locate the |
|
\series bold |
|
Single Line Text Entry Area |
|
\series default |
|
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 |
|
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 |
|
|
|
Scroll down to the Hint element, and type some text that will help students |
|
when they answer incorrectly. |
|
\layout Enumerate |
|
|
|
Click the Submit Changes button. |
|
\layout Subsection |
|
|
|
Creating Numerical Response And Formula Response Problems |
|
\layout Standard |
|
|
|
Numerical Response problems are answered by entering a number and an optional |
|
unit. |
|
For instance, a numerical response problem might have an answer of |
|
\begin_inset Formula \( 2m/s^{2} \) |
|
\end_inset |
|
|
|
. |
|
Formula Response problems are answered by entering a mathematical formula. |
|
For instance, a numerical response problem might have an answer of |
|
\begin_inset Formula \( x^{2}+11 \) |
|
\end_inset |
|
|
|
. |
|
The answer may be in any equivalent format. |
|
For instance, for |
|
\begin_inset Formula \( x^{2}+11 \) |
|
\end_inset |
|
|
|
, the system will accept |
|
\begin_inset Formula \( x*x-11 \) |
|
\end_inset |
|
|
|
or |
|
\begin_inset Formula \( x^{2}+21-10 \) |
|
\end_inset |
|
|
|
as well. |
|
\layout Standard |
|
|
|
Creating Numerical Response and Formula Response problems starts the same |
|
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 |
|
tutorial. |
|
For more information about these problem types, please see section |
|
\begin_inset LatexCommand \ref{Numerical Response} |
|
|
|
\end_inset |
|
|
|
for Numerical Response problems and section |
|
\begin_inset LatexCommand \ref{Formula Response} |
|
|
|
\end_inset |
|
|
|
for Formula Response problems. |
|
\layout Section |
|
|
|
Publishing Your Resources |
|
\layout Standard |
|
|
|
In order to make the content you've created available for courses to use, |
|
you must publish your content. |
|
LON-CAPA provides an easy interface for publishing your content pages, |
|
problem resources, and sequences. |
|
A common interface allows you to specify title, author information, keywords, |
|
and other metadata. |
|
LON-CAPA uses this metadata for many things, and it's importent to fill |
|
the metadata out as accurately as possible. |
|
\layout Subsection |
|
|
|
What is Metadata? |
|
\begin_inset LatexCommand \index{Metadata} |
|
|
|
\end_inset |
|
|
|
|
|
\begin_inset LatexCommand \label{What Is Metadata?} |
|
|
|
\end_inset |
|
|
|
|
|
\layout Standard |
|
|
|
|
|
\emph on |
|
Metadata |
|
\emph default |
|
is |
|
\emph on |
|
data about data |
|
\emph default |
|
. |
|
Metadata can often be thought of as a label on some bit of information |
|
that can be useful to people or computer programs trying to use the data. |
|
Without metadata, the person or computer trying to use the original information |
|
would have to just guess what the original data is about. |
|
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 |
|
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. |
|
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. |
|
\layout Standard |
|
|
|
One example of metadata you use all the time is the <TITLE> of a webpage, |
|
which usually shows up in the title bar of the browser. |
|
That's information about the webpage itself, not actually part of the web |
|
page. |
|
People use it 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. |
|
\layout Subsection |
|
|
|
Publishing A Resource |
|
\begin_inset LatexCommand \index{Resource, Publishing} |
|
|
|
\end_inset |
|
|
|
|
|
\begin_inset LatexCommand \index{Publishing Resource} |
|
|
|
\end_inset |
|
|
|
|
|
\layout Standard |
|
|
|
\begin_float fig |
|
\layout Standard |
|
\align center |
|
|
|
\begin_inset Figure size 476 168 |
|
file constructionSpaceForPublishing.eps |
|
width 3 80 |
|
flags 9 |
|
|
|
\end_inset |
|
|
|
|
|
\layout Caption |
|
|
|
Construction Space for Publishing |
|
\begin_inset LatexCommand \label{Construction Space for Publishing Figure} |
|
|
|
\end_inset |
|
|
|
|
|
\end_float |
|
To publish a resource, log in and choose your role to be an Author. |
|
Then click |
|
\series bold |
|
CSTR |
|
\series default |
|
to go to your construction space. |
|
You should see something like figure |
|
\begin_inset LatexCommand \ref{Construction Space for Publishing Figure} |
|
|
|
\end_inset |
|
|
|
. |
|
Click on the |
|
\series bold |
|
Publish |
|
\series default |
|
button for the resource you wish to publish. |
|
\begin_float fig |
|
\layout Standard |
|
\align center |
|
|
|
\begin_inset Figure size 476 338 |
|
file publishMetadata.eps |
|
width 3 80 |
|
flags 9 |
|
|
|
\end_inset |
|
|
|
|
|
\layout Caption |
|
|
|
Publishing Metadata Screen |
|
\begin_inset LatexCommand \label{Publishing Metadata Screen Figure} |
|
|
|
\end_inset |
|
|
|
|
|
\end_float |
|
You'll get a metadata screen that should look something like figure |
|
\begin_inset LatexCommand \ref{Publishing Metadata Screen Figure} |
|
|
|
\end_inset |
|
|
|
. |
|
Fill out the form. |
|
If you are creating resources that may be used in several courses, you |
|
should talk with the other authors and establish some sort of standard |
|
title and subject scheme in advance. |
|
|
|
\layout Standard |
|
|
|
The language is the language the problem is written in. |
|
The Publisher/Owner is the person who owns the problem; it should be the |
|
email address where anybody with questions about the resource can contact |
|
someone who can help them. |
|
In smaller environments, this is likely to be the author. |
|
In larger environments, it may be a coordinator or manager. |
|
\layout Standard |
|
|
|
The |
|
\series bold |
|
Keywords |
|
\series default |
|
and the |
|
\series bold |
|
Abstract |
|
\series default |
|
are more information about the problem. |
|
The |
|
\series bold |
|
Keywords |
|
\series default |
|
are words that are strongly connected to your problem; for instance a physics |
|
problem about a pulley might include |
|
\begin_inset Quotes eld |
|
\end_inset |
|
|
|
pulley |
|
\begin_inset Quotes erd |
|
\end_inset |
|
|
|
as a key word. |
|
LON-CAPA pulls out likely-looking keywords for you so you can just click |
|
on them to make them keywords. |
|
|
|
\series bold |
|
Additional keywords |
|
\series default |
|
allows you to add any keyword to your problem that are not actually in |
|
the problem. |
|
For instance, on that same problem a physicist might add the keyword |
|
\begin_inset Quotes eld |
|
\end_inset |
|
|
|
statics |
|
\begin_inset Quotes erd |
|
\end_inset |
|
|
|
, even though it doesn't appear in the original problem, because Physics |
|
uses that as a classification of problem type. |
|
|
|
\layout Standard |
|
|
|
Finally, you need to set the copyright and distribution notice. |
|
This setting controls who is allowed to use your resource. |
|
|
|
\layout Itemize |
|
|
|
|
|
\series bold |
|
Limited to courses in the domain published |
|
\series default |
|
means that only courses running in the same domain as you can use your |
|
content. |
|
Talk to your LON-CAPA administrator if you want more information about |
|
your domain. |
|
\layout Itemize |
|
|
|
|
|
\series bold |
|
Free |
|
\series default |
|
means that anyone can find and use the resource. |
|
\layout Itemize |
|
|
|
|
|
\series bold |
|
Private - visible to author only |
|
\series default |
|
means that it can't be used for any course. |
|
\layout Itemize |
|
|
|
|
|
\series bold |
|
Public - no authentication required |
|
\series default |
|
means anyone can find and use the resource. |
|
\layout Standard |
|
|
|
Now when you click |
|
\series bold |
|
Finalize Publication |
|
\series default |
|
, your resource will be published and usable (unless you set the distribution |
|
to |
|
\begin_inset Quotes eld |
|
\end_inset |
|
|
|
private |
|
\begin_inset Quotes erd |
|
\end_inset |
|
|
|
). |
|
\layout Standard |
|
|
|
If you're following this as a tutorial, publish your resources so we can |
|
use them in the next section. |
|
\layout Section |
|
|
|
Creating A Course |
|
\begin_inset LatexCommand \label{Creating a Course} |
|
|
|
\end_inset |
|
|
|
: Maps and Sequences |
|
\layout Standard |
|
|
|
In order to create a useful course, we need to arrange our raw materials |
|
so that students can use them. |
|
\layout Subsection |
|
|
|
Binding Together Resources In One Map: Page |
|
\begin_inset LatexCommand \index{Page} |
|
|
|
\end_inset |
|
|
|
|
|
\layout Standard |
|
|
|
\begin_float fig |
|
\layout Standard |
|
\align center |
|
|
|
\begin_inset Figure size 429 66 |
|
file mapEditingButton.eps |
|
flags 9 |
|
|
|
\end_inset |
|
|
|
|
|
\layout Caption |
|
|
|
Map Editing Button |
|
\begin_inset LatexCommand \label{Map Editing Button Figure} |
|
|
|
\end_inset |
|
|
|
|
|
\end_float |
|
To join several resources into one page, you need to create a |
|
\series bold |
|
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} |
|
|
|
\end_inset |
|
|
|
. |
|
This is a |
|
\begin_inset Quotes eld |
|
\end_inset |
|
|
|
page |
|
\begin_inset Quotes erd |
|
\end_inset |
|
|
|
resource so the URL must end in |
|
\begin_inset Quotes eld |
|
\end_inset |
|
|
|
.page |
|
\begin_inset Quotes erd |
|
\end_inset |
|
|
|
. |
|
After you enter in the URL ending in |
|
\begin_inset Quotes eld |
|
\end_inset |
|
|
|
.page |
|
\begin_inset Quotes erd |
|
\end_inset |
|
|
|
, you should see a screen as in figure |
|
\begin_inset LatexCommand \ref{Map Editing Button Figure} |
|
|
|
\end_inset |
|
|
|
. |
|
Click the button to get to the sequence editor. |
|
|
|
\begin_float fig |
|
\layout Standard |
|
\align center |
|
|
|
\begin_inset Figure size 476 226 |
|
file mapEditInitial.eps |
|
width 3 80 |
|
flags 11 |
|
|
|
\end_inset |
|
|
|
|
|
\layout Caption |
|
|
|
Initial Map Editor |
|
\begin_inset LatexCommand \label{Initial Map Editor FIgure} |
|
|
|
\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 |
|
|
|
. |
|
Note there are two windows. |
|
One is the workspace, and one is the window which will contain information |
|
as you add resources. |
|
\layout Subsection |
|
|
|
About The Editor |
|
\layout Standard |
|
|
|
\begin_float fig |
|
\layout Caption |
|
|
|
Example of the Map Editor |
|
\begin_inset LatexCommand \label{Map Editor Example Figure} |
|
|
|
\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 |
|
|
|
To facilitate editing these powerful entities, LON-CAPA has a map editor |
|
that helps you take advantage of this power, as seen in figure |
|
\begin_inset LatexCommand \ref{Map Editor Example Figure} |
|
|
|
\end_inset |
|
|
|
. |
|
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 |
|
Start |
|
\series default |
|
area and a |
|
\series bold |
|
Finish |
|
\series default |
|
area. |
|
The students in the course will progress along on path or another, depending |
|
on decisions made at each resource, as explained later. |
|
Different paths are represented with different lines in the map editor. |
|
In the example figure, there are two paths the student can go down, depending |
|
on whether or not they get the problem at the branch point correct. |
|
By the end of this section, we'll create the map represented in this figure. |
|
\layout Standard |
|
|
|
The branching ability can obviously be used to help the student understand |
|
the concept in the problem by having them go through some extra material |
|
based on their performance, but the total uses of this feature are limited |
|
only by your imagination. |
|
\layout Subsection |
|
|
|
Creating a Simple Map: Page |
|
\layout Standard |
|
|
|
To add a resource to the map: |
|
\layout Enumerate |
|
|
|
Click on an unused light gray area. |
|
\begin_float fig |
|
\layout Standard |
|
\align center |
|
|
|
\begin_inset Figure size 476 242 |
|
file mapEditFirstClick.eps |
|
width 3 80 |
|
flags 9 |
|
|
|
\end_inset |
|
|
|
|
|
\layout Caption |
|
|
|
Map Editor after clicking on the box labelled |
|
\begin_inset Quotes eld |
|
\end_inset |
|
|
|
here |
|
\begin_inset Quotes erd |
|
\end_inset |
|
|
|
. |
|
|
|
\begin_inset LatexCommand \label{Map Editor First Click Figure} |
|
|
|
\end_inset |
|
|
|
|
|
\end_float |
|
In figure |
|
\begin_inset LatexCommand \ref{Map Editor First Click Figure} |
|
|
|
\end_inset |
|
|
|
, the map editor after clicking on the area labelled |
|
\begin_inset Quotes eld |
|
\end_inset |
|
|
|
here |
|
\begin_inset Quotes erd |
|
\end_inset |
|
|
|
is shown. |
|
In that figure, lines have been added to show where the box boundaries |
|
are for the purposes of demonstration. |
|
This is to allow you to stay in sync with this tutorial; normally this |
|
doesn't matter. |
|
|
|
\begin_deeper |
|
\layout Standard |
|
|
|
Note that the contents of the seperate window have changed. |
|
\end_deeper |
|
\layout Enumerate |
|
|
|
\begin_float fig |
|
\layout Standard |
|
\align center |
|
|
|
\begin_inset Figure size 476 218 |
|
file mapNewResource.eps |
|
width 3 80 |
|
flags 9 |
|
|
|
\end_inset |
|
|
|
|
|
\layout Caption |
|
|
|
Map Resource Editor |
|
\begin_inset LatexCommand \label{Map Resource Editor Figure} |
|
|
|
\end_inset |
|
|
|
|
|
\end_float |
|
Click on |
|
\series bold |
|
Insert Resource |
|
\series default |
|
in the secondary window. |
|
A |
|
\series bold |
|
Resource |
|
\series default |
|
will appear in the map editor. |
|
Click on the new Resource, and you'll get something like Figure |
|
\begin_inset LatexCommand \ref{Map Resource Editor Figure} |
|
|
|
\end_inset |
|
|
|
will show appear. |
|
Click |
|
\series bold |
|
Browse |
|
\series default |
|
, and the |
|
\series bold |
|
Network Directory Browser |
|
\series default |
|
will appear, |
|
\begin_float fig |
|
\layout Standard |
|
\align center |
|
|
|
\begin_inset Figure size 476 216 |
|
file mapEditorDirectoryBrowser.eps |
|
width 3 80 |
|
flags 9 |
|
|
|
\end_inset |
|
|
|
|
|
\layout Caption |
|
|
|
Network Directory Browser |
|
\begin_inset LatexCommand \label{Map Editor Network Directory Browser Figure} |
|
|
|
\end_inset |
|
|
|
|
|
\end_float |
|
looking something like figure |
|
\begin_inset LatexCommand \ref{Map Editor Network Directory Browser Figure} |
|
|
|
\end_inset |
|
|
|
. |
|
Press the select button that is next to the resource you want to include. |
|
\begin_float fig |
|
\layout Standard |
|
\align center |
|
|
|
\begin_inset Figure size 476 213 |
|
file mapEditorResourceChosen.eps |
|
width 3 80 |
|
flags 9 |
|
|
|
\end_inset |
|
|
|
|
|
\layout Caption |
|
|
|
Resource Chosen |
|
\begin_inset LatexCommand \label{Map Resource Chosen Figure} |
|
|
|
\end_inset |
|
|
|
(HTML page) |
|
\end_float |
|
Once you've done that, if you look back at the window that popped up when |
|
you clicked on |
|
\series bold |
|
New Resource |
|
\series default |
|
, you'll see something like figure |
|
\begin_inset LatexCommand \ref{Map Resource Chosen Figure} |
|
|
|
\end_inset |
|
|
|
. |
|
You can type the |
|
\series bold |
|
URL |
|
\series default |
|
and |
|
\series bold |
|
Title |
|
\series default |
|
if you prefer, following the format you see above. |
|
After you click |
|
\series bold |
|
Save Changes |
|
\series default |
|
, your changes will be saved, and the icons for the resource will appear |
|
in the |
|
\series bold |
|
Res |
|
\series default |
|
box, as shown in figure |
|
\begin_inset LatexCommand \ref{Map Resource Chosen Figure} |
|
|
|
\end_inset |
|
|
|
. |
|
\begin_deeper |
|
\layout Standard |
|
|
|
Clicking on the left icon for a resource will open a new browser window |
|
with an informational page about that resource. |
|
Clicking on the right icon for a resource will open a new browser window |
|
taking you to the rendering of that resource. |
|
\end_deeper |
|
\layout Enumerate |
|
|
|
Let's give practice giving ourselves a bit more space. |
|
Click on the grey space just left of your resource, and select |
|
\series bold |
|
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 |
|
|
|
Now, in the map editor window, click just to the left of the |
|
\series bold |
|
Res |
|
\series default |
|
box. |
|
\begin_float fig |
|
\layout Standard |
|
\align center |
|
|
|
\begin_inset Figure size 357 190 |
|
file mapSecondWindowSecondResource.eps |
|
flags 9 |
|
|
|
\end_inset |
|
|
|
|
|
\layout Caption |
|
|
|
Choosing your second resource |
|
\begin_inset LatexCommand \label{Map Second Resource Figure} |
|
|
|
\end_inset |
|
|
|
|
|
\end_float |
|
The secondary window will appear as it does in figure |
|
\begin_inset LatexCommand \ref{Map Second Resource Figure} |
|
|
|
\end_inset |
|
|
|
, but for now just choose |
|
\series bold |
|
Insert Resource |
|
\series default |
|
again, not the new options. |
|
Insert a resource in the same manner as before. |
|
\begin_float fig |
|
\layout Standard |
|
\align center |
|
|
|
\begin_inset Figure size 476 243 |
|
file mapTwoResources.eps |
|
width 3 80 |
|
flags 11 |
|
|
|
\end_inset |
|
|
|
|
|
\layout Caption |
|
|
|
Two Resource in the Map Editor |
|
\begin_inset LatexCommand \label{Two Resources in the Map Editor Figure} |
|
|
|
\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 |
|
|
|
, though the exact placement may differ. |
|
Now we need to link them together. |
|
\layout Enumerate |
|
|
|
Click the Start box. |
|
In the secondary window, select |
|
\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 |
|
|
|
Numerical Response |
|
\begin_inset LatexCommand \index{Numerical Response} |
|
|
|
\end_inset |
|
|
|
|
|
\begin_inset LatexCommand \label{Numerical Response} |
|
|
|
\end_inset |
|
|
|
Problems |
|
\layout Standard |
|
|
|
Numerical Response problems are very powerful. |
|
In fact, they are so powerful it would be impossible to fully explain what |
|
is possible in a document like this. |
|
This chapter will focus on just getting you started with Numerical Response |
|
problems, and showing you some of the possibilities, with no prerequisite |
|
knowlege necessary. |
|
The more you learn, the more you will find you can do. |
|
\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. |
|
Create a Numerical Response problem using the instructions in section |
|
\begin_inset LatexCommand \ref{Creating New Content Pages} |
|
|
|
\end_inset |
|
|
|
, ending your resource name with |
|
\begin_inset Quotes eld |
|
\end_inset |
|
|
|
.problem |
|
\begin_inset Quotes erd |
|
\end_inset |
|
|
|
, and create a new |
|
\series bold |
|
Simple Numerical Response |
|
\series default |
|
problem. |
|
\layout Subsection |
|
|
|
The Parts of a Numerical Response Problem |
|
\layout Standard |
|
|
|
\begin_float fig |
|
\layout Standard |
|
\align center |
|
|
|
\begin_inset Figure size 476 356 |
|
file numericalResponse1.eps |
|
width 3 80 |
|
flags 9 |
|
|
|
\end_inset |
|
|
|
|
|
\layout Caption |
|
|
|
Numerical Response editor |
|
\begin_inset LatexCommand \label{Numerical Response Editor Figure} |
|
|
|
\end_inset |
|
|
|
|
|
\end_float |
|
A Numerical Response problem has seven major parts by default, as seen in |
|
figure |
|
\begin_inset LatexCommand \ref{Numerical Response Editor Figure} |
|
|
|
\end_inset |
|
|
|
: |
|
\layout Enumerate |
|
|
|
The |
|
\series bold |
|
Script |
|
\series default |
|
. |
|
The script is the heart of advanced Numerical Response problems. |
|
It can be used to decide some of the parameters of the problem, compute |
|
the answer to the problem, and do just about anything else you can imagine. |
|
The Script language is |
|
\series bold |
|
Perl |
|
\begin_float footnote |
|
\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 |
|
through some advanced examples in this chapter, but knowing Perl can help. |
|
\layout Enumerate |
|
|
|
Like other problem types, the |
|
\series bold |
|
Text Block |
|
\series default |
|
is used to display the problem the student will see. |
|
In addition, you can place things in the |
|
\series bold |
|
Text Block |
|
\series default |
|
based on computations done in the |
|
\series bold |
|
Script |
|
\series default |
|
. |
|
\layout Enumerate |
|
|
|
The |
|
\series bold |
|
Answer |
|
\series default |
|
is the answer the system is looking for. |
|
This can also use parameters from the |
|
\series bold |
|
Script |
|
\series default |
|
block, allowing the answer to be computed dynamically. |
|
\layout Enumerate |
|
|
|
A |
|
\series bold |
|
tolerance |
|
\begin_inset LatexCommand \index{tolerance} |
|
|
|
\end_inset |
|
|
|
|
|
\series default |
|
parameter, which determines how closely the system will require the student |
|
answer to be in order to count it correct. |
|
For technical reasons, it is almost never a good idea to set this parameter |
|
to zero |
|
\begin_float footnote |
|
\layout Standard |
|
|
|
Computers can only approximate computations involving real numbers. |
|
For instance, a computer's [decimal] answer to the simple problem |
|
\begin_inset Formula \( \frac{1}{3} \) |
|
\end_inset |
|
|
|
is |
|
\begin_inset Quotes eld |
|
\end_inset |
|
|
|
0.33333333333333331 |
|
\begin_inset Quotes erd |
|
\end_inset |
|
|
|
. |
|
It |
|
\emph on |
|
should |
|
\emph default |
|
be an infinite series of 3's, and there certainly shouldn't be a |
|
\begin_inset Quotes eld |
|
\end_inset |
|
|
|
1 |
|
\begin_inset Quotes erd |
|
\end_inset |
|
|
|
in the answer, but no computer can represent an infinitely long, infinitely |
|
detailed real number. |
|
Therefore, for any problem where the answer is not a small integer, you |
|
|
|
\emph on |
|
need |
|
\emph default |
|
to allow a tolerance factor, or the students will find it nearly impossible |
|
to exactly match the computers idea of the answer. |
|
\end_float |
|
, though you may find the default too large for some problems. |
|
There are two kinds of tolerance. |
|
If there is some answer |
|
\begin_inset Formula \( a \) |
|
\end_inset |
|
|
|
and a tolerance |
|
\begin_inset Formula \( t \) |
|
\end_inset |
|
|
|
, |
|
\begin_deeper |
|
\layout Enumerate |
|
|
|
an |
|
\series bold |
|
Absolute |
|
\series default |
|
tolerance |
|
\begin_inset LatexCommand \index{absolute tolerance} |
|
|
|
\end_inset |
|
|
|
|
|
\begin_inset LatexCommand \index{tolerance, absolute} |
|
|
|
\end_inset |
|
|
|
will take anything in the range |
|
\begin_inset Formula \( a\pm t \) |
|
\end_inset |
|
|
|
. |
|
So if |
|
\begin_inset Formula \( a=10 \) |
|
\end_inset |
|
|
|
and |
|
\begin_inset Formula \( t=2 \) |
|
\end_inset |
|
|
|
, then anything between 8 and 12 is acceptable |
|
\begin_float footnote |
|
\end_deeper |
|
\layout Standard |
|
|
|
For much the same reasons a tolerance is almost always a good idea, it's |
|
almost impossible to say whether an answer that is |
|
\emph on |
|
exactly |
|
\emph default |
|
|
|
\begin_inset Formula \( a\pm t \) |
|
\end_inset |
|
|
|
will be accepted by the computer. |
|
But the computer does use many decimal places of accuracy; if you want |
|
to have the student answer exactly |
|
\begin_inset Quotes eld |
|
\end_inset |
|
|
|
2 |
|
\begin_inset Quotes erd |
|
\end_inset |
|
|
|
, then specifying a tolerance of |
|
\begin_inset Quotes eld |
|
\end_inset |
|
|
|
.0000001 |
|
\begin_inset Quotes erd |
|
\end_inset |
|
|
|
is OK. |
|
(Don't use too many more zeros, though you can use less if you like.) |
|
\end_float |
|
. |
|
Any number in the tolerance field |
|
\emph on |
|
without |
|
\emph default |
|
a |
|
\series bold |
|
% |
|
\series default |
|
symbol is an absolute tolerance. |
|
\begin_deeper |
|
\layout Enumerate |
|
|
|
a |
|
\series bold |
|
Relative |
|
\series default |
|
tolerance |
|
\begin_inset LatexCommand \index{relative tolerance} |
|
|
|
\end_inset |
|
|
|
|
|
\begin_inset LatexCommand \index{tolerance, relative} |
|
|
|
\end_inset |
|
|
|
will take anything in the range |
|
\begin_inset Formula \( a\pm at \) |
|
\end_inset |
|
|
|
, where |
|
\emph on |
|
t |
|
\emph default |
|
is interpreted as a percentage. |
|
Any number in the tolerance field |
|
\emph on |
|
with |
|
\emph default |
|
a |
|
\series bold |
|
% |
|
\series default |
|
symbol is a relative tolerance. |
|
For example, |
|
\begin_inset Formula \( a=10 \) |
|
\end_inset |
|
|
|
and |
|
\begin_inset Formula \( t=10\% \) |
|
\end_inset |
|
|
|
will accept anything between 9 and 11. |
|
|
|
\end_deeper |
|
\layout Enumerate |
|
|
|
A |
|
\series bold |
|
significant figures |
|
\series default |
|
specification tells the system how many significant figures there are in |
|
the problem, as either a single number or a range of acceptable values, |
|
expressed as |
|
\series bold |
|
min,max |
|
\series default |
|
. |
|
The system will check to make sure that the student's answer contains this |
|
many significant digits, useful in many scientific calculations. |
|
For example, if the problem has three significant digits, the significant |
|
digit specification is |
|
\begin_inset Quotes eld |
|
\end_inset |
|
|
|
3 |
|
\begin_inset Quotes erd |
|
\end_inset |
|
|
|
, and the answer is |
|
\begin_inset Quotes eld |
|
\end_inset |
|
|
|
1.3 |
|
\begin_inset Quotes erd |
|
\end_inset |
|
|
|
, the system will require the students to type |
|
\begin_inset Quotes eld |
|
\end_inset |
|
|
|
1.30 |
|
\begin_inset Quotes erd |
|
\end_inset |
|
|
|
, even though numerically, |
|
\begin_inset Quotes eld |
|
\end_inset |
|
|
|
1.3 |
|
\begin_inset Quotes erd |
|
\end_inset |
|
|
|
and |
|
\begin_inset Quotes eld |
|
\end_inset |
|
|
|
1.30 |
|
\begin_inset Quotes erd |
|
\end_inset |
|
|
|
are the same. |
|
\begin_deeper |
|
\layout Comment |
|
|
|
Confirm this. |
|
\end_deeper |
|
\layout Enumerate |
|
|
|
The |
|
\series bold |
|
Single Line Text Entry |
|
\series default |
|
area, as in other problems, allow you to manipulate the text entry area |
|
the student will see. |
|
\layout Enumerate |
|
|
|
Finally, the |
|
\series bold |
|
Hint |
|
\series default |
|
provides a place to help students who get the problem incorrect the first |
|
time. |
|
\layout Subsection |
|
|
|
Simple Numerical Response Answer |
|
\layout Standard |
|
|
|
Along with showing the Numerical Response editor, figure |
|
\begin_inset LatexCommand \ref{Numerical Response Editor Figure} |
|
|
|
\end_inset |
|
|
|
also shows the parameters for one of the simplest possible types of numerical |
|
response. |
|
The |
|
\series bold |
|
Text Block |
|
\series default |
|
has the problem's question, which is the static text |
|
\begin_inset Quotes eld |
|
\end_inset |
|
|
|
What is 2 + 2? |
|
\begin_inset Quotes erd |
|
\end_inset |
|
|
|
The |
|
\series bold |
|
Answer |
|
\series default |
|
is |
|
\begin_inset Quotes eld |
|
\end_inset |
|
|
|
4 |
|
\begin_inset Quotes erd |
|
\end_inset |
|
|
|
. |
|
The |
|
\series bold |
|
Hint |
|
\series default |
|
has been set to something appropriate for this problem (unless this problem |
|
is being given to very young children). |
|
Everything else has the default values from when the problem was created. |
|
\layout Standard |
|
|
|
If you create a problem like this, hit |
|
\series bold |
|
Submit Changes |
|
\series default |
|
, then hit |
|
\series bold |
|
View |
|
\series default |
|
after the changes have been submitted, you can try the problem out for |
|
yourself. |
|
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 |
|
accept and the number of significant digits the computer requires. |
|
\layout Standard |
|
|
|
As you're playing with the problem, if you use up all your tries or get |
|
the answer correct but wish to continue playing with the problem, use the |
|
|
|
\series bold |
|
Reset Submissions |
|
\series default |
|
button to clear your answer attempts. |
|
|
|
\layout Subsection |
|
|
|
Simple Script Usage |
|
\layout Standard |
|
|
|
Totally static problems only scratch the surface of the Numerical Response |
|
capabilities. |
|
To really explore the power of LON-CAPA, we need to start creating dynamic |
|
problems. |
|
But before we can get to truly dynamic problems, we need to learn how to |
|
work with the |
|
\series bold |
|
Script |
|
\begin_inset LatexCommand \index{Script} |
|
|
|
\end_inset |
|
|
|
|
|
\series default |
|
window. |
|
\layout Standard |
|
|
|
A script consists of several |
|
\series bold |
|
statements |
|
\series default |
|
, seperated by |
|
\series bold |
|
semi-colons |
|
\series default |
|
. |
|
A |
|
\series bold |
|
statement |
|
\begin_inset LatexCommand \index{statement} |
|
|
|
\end_inset |
|
|
|
|
|
\series default |
|
is the smallest kind of instruction to the computer you can give. |
|
Most problems will be built from several statements. |
|
|
|
\layout Standard |
|
|
|
A script can contain |
|
\series bold |
|
comments |
|
\series default |
|
, which are not interpreted as statements by the computer. |
|
Comments start with |
|
\series bold |
|
# |
|
\series default |
|
, and go to the end of that line. |
|
Thus, if a line starts with #, the whole line is ignored. |
|
Comments can also begin in the middle of a line. |
|
It is a good idea to comment more complicated scripts, as it can be very |
|
difficult to read a large script and figure out what it does. |
|
It is a |
|
\emph on |
|
very |
|
\emph default |
|
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. |
|
\layout Standard |
|
|
|
One of the simplest statements in LON-CAPA is a |
|
\series bold |
|
variable assignment |
|
\series default |
|
. |
|
A |
|
\series bold |
|
variable |
|
\series default |
|
can hold any value in it. |
|
Simple values, such as a number or a string of text, start with a |
|
\series bold |
|
$ |
|
\series default |
|
. |
|
In the |
|
\series bold |
|
Script |
|
\series default |
|
, you need to assign to variables before you use them. |
|
Put the program in Figure |
|
\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 |
|
Script |
|
\series default |
|
field of the Numerical Response. |
|
This creates a simple variable named |
|
\series bold |
|
variable |
|
\series default |
|
and assigns it the value of |
|
\begin_inset Quotes eld |
|
\end_inset |
|
|
|
3 |
|
\begin_inset Quotes erd |
|
\end_inset |
|
|
|
. |
|
That's one statement. |
|
\layout Standard |
|
|
|
Variable names are |
|
\emph on |
|
case sensitive |
|
\emph default |
|
, must start with a letter, and can only consist of letters, numbers, and |
|
underscores. |
|
Variable names can be as long as you want. |
|
|
|
\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 |
|
how to capatalize variables |
|
\begin_float footnote |
|
\layout Standard |
|
|
|
The author favors |
|
\family typewriter |
|
capsOnNewWords |
|
\family default |
|
. |
|
Some people use |
|
\family typewriter |
|
underscore_to_seperate_words |
|
\family default |
|
. |
|
Many use uppercase letters to specify constants like |
|
\family typewriter |
|
PI |
|
\family default |
|
or |
|
\family typewriter |
|
GOLDEN_MEAN |
|
\family default |
|
. |
|
Some people always |
|
\family typewriter |
|
StartWithCapatalization |
|
\family default |
|
. |
|
What's really importent is to be consistent, so you don't have to guess |
|
whether the variable you're thinking of is |
|
\family typewriter |
|
coefFriction |
|
\family default |
|
, |
|
\family typewriter |
|
CoefFriction |
|
\family default |
|
, |
|
\family typewriter |
|
COEF_FRICTION |
|
\family default |
|
, or something else. |
|
\end_float |
|
. |
|
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 |
|
and agree on a convention. |
|
|
|
\layout Standard |
|
|
|
If you |
|
\series bold |
|
Submit Changes |
|
\series default |
|
and |
|
\series bold |
|
View |
|
\series default |
|
the problem, you'll see nothing has changed. |
|
That's because in order for a variable to be useful, it must be used. |
|
The variable can be used in several places. |
|
\layout Subsubsection |
|
|
|
Variables in Scripts |
|
\layout Standard |
|
|
|
Variables can be used later in the same script. |
|
For instance, we can add another line below the |
|
\family typewriter |
|
$variable |
|
\family default |
|
line as such: |
|
\layout LyX-Code |
|
|
|
$variable2 = $variable + 2; |
|
\layout Standard |
|
|
|
Now there's a variable called |
|
\family typewriter |
|
$variable2 |
|
\family default |
|
with the value |
|
\begin_inset Quotes eld |
|
\end_inset |
|
|
|
5 |
|
\begin_inset Quotes erd |
|
\end_inset |
|
|
|
. |
|
|
|
\layout Standard |
|
|
|
Variables can also be used in |
|
\emph on |
|
strings |
|
\emph default |
|
|
|
\begin_inset LatexCommand \index{strings} |
|
|
|
\end_inset |
|
|
|
, which are a sequence of letters. |
|
The underlying language of the script, Perl, has a very large number of |
|
ways of using variables in strings, but the easiest and most common way |
|
is to use normal double-quotes and just spell out the name of the variable |
|
you want to use in the string, like this: |
|
\layout LyX-Code |
|
|
|
$stringVar = |
|
\begin_inset Quotes eld |
|
\end_inset |
|
|
|
I have a variable with the value $variable. |
|
\begin_inset Quotes erd |
|
\end_inset |
|
|
|
|
|
\layout Standard |
|
|
|
This will put the string |
|
\begin_inset Quotes eld |
|
\end_inset |
|
|
|
I have a variable with the value 3. |
|
\begin_inset Quotes erd |
|
\end_inset |
|
|
|
into the variable named |
|
\begin_inset Quotes eld |
|
\end_inset |
|
|
|
stringVar |
|
\begin_inset Quotes erd |
|
\end_inset |
|
|
|
. |
|
\layout Standard |
|
|
|
If you are following this chapter as a tutorial, add the previous two lines |
|
and save the problem. |
|
There's no need to view it; there's still no visible change. |
|
\layout Subsubsection |
|
|
|
Variables in the Text Block |
|
\layout Standard |
|
|
|
Once you've defined variables in the |
|
\series bold |
|
Script |
|
\series default |
|
, you can use them in the |
|
\series bold |
|
Text Block |
|
\series default |
|
. |
|
For example, using the previous three-line script we've created so far, |
|
you can place the following in the |
|
\series bold |
|
Text Block |
|
\series default |
|
: |
|
\layout LyX-Code |
|
|
|
See the 3: $variable<br /> |
|
\layout LyX-Code |
|
|
|
See the string: <b>$stringVar</b><br /> |
|
\layout Standard |
|
|
|
\begin_float fig |
|
\layout Standard |
|
\align center |
|
|
|
\begin_inset Figure size 353 99 |
|
file numericalResponseVarInText.eps |
|
flags 9 |
|
|
|
\end_inset |
|
|
|
|
|
\layout Caption |
|
|
|
Result of Variables in the Text Block |
|
\begin_inset LatexCommand \label{Result of Variables in the Text Block Figure} |
|
|
|
\end_inset |
|
|
|
|
|
\end_float |
|
If you save that and hit |
|
\series bold |
|
View |
|
\series default |
|
, you should get what you see in figure |
|
\begin_inset LatexCommand \ref{Result of Variables in the Text Block Figure} |
|
|
|
\end_inset |
|
|
|
. |
|
Note how the |
|
\begin_inset Quotes eld |
|
\end_inset |
|
|
|
$variable |
|
\begin_inset Quotes erd |
|
\end_inset |
|
|
|
was turned into a 3, and the |
|
\begin_inset Quotes eld |
|
\end_inset |
|
|
|
$stringVar |
|
\begin_inset Quotes erd |
|
\end_inset |
|
|
|
was turned into |
|
\begin_inset Quotes eld |
|
\end_inset |
|
|
|
I have a variable with the value 3. |
|
\begin_inset Quotes erd |
|
\end_inset |
|
|
|
|
|
\layout Subsubsection |
|
|
|
Variables in the Answer Block |
|
\layout Standard |
|
|
|
You can use variables in the |
|
\series bold |
|
Answer |
|
\series default |
|
part of the question, too. |
|
This means you can compute an answer to a question, which we'll see in |
|
a bit. |
|
If you set the answer of the question to be |
|
\begin_inset Quotes eld |
|
\end_inset |
|
|
|
$variable |
|
\begin_inset Quotes erd |
|
\end_inset |
|
|
|
(without the quotes), |
|
\series bold |
|
Save Changes |
|
\series default |
|
and |
|
\series bold |
|
View |
|
\series default |
|
it, you'll see that LON-CAPA is now expecting |
|
\begin_inset Quotes eld |
|
\end_inset |
|
|
|
3 |
|
\begin_inset Quotes erd |
|
\end_inset |
|
|
|
as the answer, plus or minus 5%. |
|
\layout Subsection |
|
|
|
Calling Functions |
|
\layout Standard |
|
|
|
Now you've seen how to use variables and stuff, see how to call functions. |
|
\layout Subsubsection |
|
|
|
Randomization |
|
\begin_inset LatexCommand \index{Randomization} |
|
|
|
\end_inset |
|
|
|
|
|
\layout Standard |
|
|
|
One of the most importent functions for LON-CAPA is the RANDOM function. |
|
\layout Subsection |
|
|
|
Dynamic, Randomized Problems: Putting It All Together |
|
\layout Standard |
|
|
|
placeholder |
|
\layout Subsection |
|
|
|
For More Information |
|
\layout Standard |
|
|
|
It's always a good idea to look at other people's LON-CAPA problems, especially |
|
those from the same discipline as your problems, and see what they are |
|
doing. |
|
|
|
\series bold |
|
Very often, the easiest way to create a new problem is to copy it and modify |
|
the copy until it does what you need. |
|
|
|
\series default |
|
The more complicated a problem is, the more time you'll save by doing this. |
|
Also, you may find new ideas you can use and elaborate in your problems. |
|
\layout Comment |
|
|
|
Is there UI for this? Check. |
|
\layout Standard |
|
|
|
The full power of the Perl is well outside the scope of this document. |
|
Without going into the same level of detail as the previous examples, here's |
|
some ideas to stimulate your imagination: |
|
\layout Itemize |
|
|
|
Variable text. |
|
|
|
\layout Itemize |
|
|
|
Perl has several other data structures which might be of use. |
|
You may wish to do one of the many simple Perl tutorials on the Web. |
|
I recommend searching Google for |
|
\begin_inset Quotes eld |
|
\end_inset |
|
|
|
perl tutorial |
|
\begin_inset Quotes erd |
|
\end_inset |
|
|
|
. |
|
\layout Section |
|
|
|
Formula Response |
|
\begin_inset LatexCommand \index{Formula Response} |
|
|
|
\end_inset |
|
|
|
|
|
\begin_inset LatexCommand \label{Formula Response} |
|
|
|
\end_inset |
|
|
|
Problems |
|
\layout Section |
|
|
|
Additional Problem Components |
|
\layout Standard |
|
|
|
Using the |
|
\begin_inset Quotes eld |
|
\end_inset |
|
|
|
Insert |
|
\begin_inset Quotes erd |
|
\end_inset |
|
|
|
menu that appears in many of the problem editors, a wide variety of different |
|
things can be added to the problems. |
|
\layout Section |
|
|
|
Things That Need To Be Added |
|
\layout Subsection |
|
|
|
LON-CAPA and Units |
|
\layout Subsection |
|
|
|
Creating a default metadata file |
|
\layout Subsection |
|
|
|
My questions\SpecialChar \ldots{} |
|
|
|
\layout Itemize |
|
|
|
How do I do the things above? |
|
\layout Itemize |
|
|
|
Is there any pre-existing documentation for number or formula problems? |
|
\layout Itemize |
|
|
|
Is there any pre-existing documentation for maps et al? I seem to have exhausted |
|
the documentation. |
|
\layout Itemize |
|
|
|
What is the LON-CAPA default resource? If it's free, can just anyone |
|
\begin_inset Quotes eld |
|
\end_inset |
|
|
|
find and use it |
|
\begin_inset Quotes erd |
|
\end_inset |
|
|
|
, or just |
|
\begin_inset Quotes eld |
|
\end_inset |
|
|
|
use it if they already know where it is |
|
\begin_inset Quotes erd |
|
\end_inset |
|
|
|
? (In other words, how powerful is the search feature?) What's the difference |
|
between free and public? |
\layout Section |
\layout Section |
|
|
Appendix A: Student Interface |
Appendix A: Student Interface |
Line 1097 ANOT (ANOTATE)
|
Line 4109 ANOT (ANOTATE)
|
LOGOUT (LOGOUT) |
LOGOUT (LOGOUT) |
\series default |
\series default |
will log you out of the LON-CAPA system. |
will log you out of the LON-CAPA system. |
|
\layout Standard |
|
|
|
|
|
\begin_inset LatexCommand \printindex{} |
|
|
|
\end_inset |
|
|
|
|
\the_end |
\the_end |