version 1.2, 2002/05/31 13:51:31
|
version 1.4, 2002/06/03 21:29:28
|
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 |
\layout Standard |
\added_space_top vfill \align center |
\added_space_top vfill \align center |
\SpecialChar ~ |
\SpecialChar ~ |
Line 120 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 |
|
. |
|
Function names and scripts will be shown in a |
|
\family typewriter |
|
typewriter font |
|
\family 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 180 Fill in the Username and Password boxes
|
Line 224 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 312 ROLES
|
Line 354 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 389 The upshot is that the only upside to th
|
Line 389 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 525 Content Page
|
Line 524 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 573 Sequence
|
Line 572 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 873 How to Create New Content Pages
|
Line 872 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 958 Save and then attempt to clean HTML
|
Line 951 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 1010 Save and then attempt to clean HTML
|
Line 1008 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 1103 String Response
|
Line 1106 String Response
|
for the answer. |
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 Comment |
|
|
|
Case sensitivity? |
|
\layout Standard |
\layout Standard |
|
|
Note that it is easy to abuse String Response problems. |
Note that it is easy to abuse String Response problems. |
Line 1147 Samuel Clements
|
Line 1147 Samuel Clements
|
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 |
correct answers. |
correct answers. |
\layout Comment |
|
|
|
Check this stuff. |
|
\layout Subsubsection |
\layout Subsubsection |
|
|
Numerical Response Problems |
Numerical Response Problems |
Line 1675 Example: Matching Problem
|
Line 1672 Example: Matching Problem
|
You might want to ask the student to match musical compositions with their |
You might want to ask the student to match musical compositions with their |
composers. |
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 one concept group: |
place the following four things each in their own concept group: |
\layout Itemize |
\layout Itemize |
|
|
Claire de Lune |
Claire de Lune |
|
\begin_inset LatexCommand \index{Clair de Lune} |
|
|
|
\end_inset |
|
|
|
|
\begin_float footnote |
\begin_float footnote |
\layout Standard |
\layout Standard |
|
|
Line 2236 Scroll down to the Hint element, and typ
|
Line 2238 Scroll down to the Hint element, and typ
|
Click the Submit Changes button. |
Click the Submit Changes button. |
\layout Subsection |
\layout Subsection |
|
|
Creating Numerical Response |
Creating Numerical Response And Formula Response Problems |
\begin_inset LatexCommand \index{Numerical Response} |
|
|
|
\end_inset |
|
|
|
|
|
\begin_inset LatexCommand \label{Numerical Response} |
|
|
|
\end_inset |
|
|
|
Problems |
|
\layout Standard |
\layout Standard |
|
|
Numerical Response problems are answered by entering a number and an optional |
Numerical Response problems are answered by entering a number and an optional |
Line 2256 Numerical Response problems are answered
|
Line 2248 Numerical Response problems are answered
|
\end_inset |
\end_inset |
|
|
. |
. |
\layout Standard |
Formula Response problems are answered by entering a mathematical formula. |
|
|
To create an Numerical 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 Numerical 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 302 |
|
file numericalResponseEditor.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 |
|
You should see the String Response editor page open up, which should look |
|
something like what you see in figure |
|
\begin_inset LatexCommand \ref{Numerical Response Editor Figure} |
|
|
|
\end_inset |
|
|
|
. |
|
\layout Enumerate |
|
|
|
Please refer to the CAPA manual for help with Numerical Response Problems. |
|
\layout Comment |
|
|
|
Copout. |
|
I need this info. |
|
\layout Subsection |
|
|
|
Creating Formula Response |
|
\begin_inset LatexCommand \index{Formula Response} |
|
|
|
\end_inset |
|
|
|
|
|
\begin_inset LatexCommand \label{Formula Response} |
|
|
|
\end_inset |
|
|
|
Problems |
|
\layout Standard |
|
|
|
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 |
|
|
Line 2383 Formula Response problems are answered b
|
Line 2270 Formula Response problems are answered b
|
as well. |
as well. |
\layout Standard |
\layout Standard |
|
|
To create an Formula Response problem, create a new resource as described |
Creating Numerical Response and Formula Response problems starts the same |
in section |
as the other problem types, but because of the power of Numerical Response |
\begin_inset LatexCommand \ref{Creating New Content Pages} |
and Formula Response problems, it is too difficult to cover them in this |
|
tutorial. |
\end_inset |
For more information about these problem types, please see section |
|
\begin_inset LatexCommand \ref{Numerical Response} |
. |
|
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 Formula 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 302 |
|
file numericalResponseEditor.eps |
|
width 3 80 |
|
flags 9 |
|
|
|
\end_inset |
|
|
|
|
|
\layout Caption |
|
|
|
Numerical Response Editor |
|
\begin_inset LatexCommand \label{Numerical Response Editor Figure} |
|
|
|
\end_inset |
\end_inset |
|
|
|
for Numerical Response problems and section |
\end_float |
\begin_inset LatexCommand \ref{Formula Response} |
You should see the Formula Response editor page open up, which should look |
|
something like what you see in figure |
|
\begin_inset LatexCommand \ref{Numerical Response Editor Figure} |
|
|
|
\end_inset |
\end_inset |
|
|
. |
for Formula Response problems. |
\layout Enumerate |
|
|
|
Please refer to the CAPA manual for help with Numerical Response Problems. |
|
\layout Comment |
|
|
|
Copout. |
|
I need this info. |
|
\layout Section |
\layout Section |
|
|
Publishing Your Course |
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 courses to use, |
Line 2715 private
|
Line 2529 private
|
\end_inset |
\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 |
\layout Section |
|
|
Things That Need To Be Added |
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 |
\layout Subsection |
|
|
LON-CAPA and Units |
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 Comment |
|
|
|
The following is a commented-out section of the manual, likely to not be |
|
useful. |
|
\layout Comment |
|
|
|
About The Editor |
|
\layout Comment |
|
|
|
\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, going 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 which will provide more help for the student. |
|
|
|
\layout Comment |
|
|
|
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 Comment |
|
|
|
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 |
\layout Subsection |
|
|
Creating a default metadata file |
Creating a Simple Map: Page |
|
\begin_inset LatexCommand \index{Page} |
|
|
|
\end_inset |
|
|
|
|
|
\layout Standard |
|
|
|
To create a simple page that joins several resources into one page: |
|
\layout Enumerate |
|
|
|
\begin_float fig |
|
\layout Standard |
|
\align center |
|
|
|
\begin_inset Figure size 476 221 |
|
file mapClickedStart.eps |
|
width 3 80 |
|
flags 9 |
|
|
|
\end_inset |
|
|
|
|
|
\layout Caption |
|
|
|
Clicked Start in the Map Constructor |
|
\begin_inset LatexCommand \label{Clicked Start Figure} |
|
|
|
\end_inset |
|
|
|
|
|
\end_float |
|
Click the Start box. |
|
You'll see what you see in figure |
|
\begin_inset LatexCommand \ref{Clicked Start Figure} |
|
|
|
\end_inset |
|
|
|
. |
|
Click |
|
\begin_inset Quotes eld |
|
\end_inset |
|
|
|
Link Resource |
|
\begin_inset Quotes erd |
|
\end_inset |
|
|
|
in the secondary window, then click on the Finish box. |
|
\begin_float fig |
|
\layout Standard |
|
\align center |
|
|
|
\begin_inset Figure size 120 360 |
|
file mapStraightened.eps |
|
flags 9 |
|
|
|
\end_inset |
|
|
|
|
|
\layout Caption |
|
|
|
Straightened Map |
|
\begin_inset LatexCommand \label{Striaghtened map} |
|
|
|
\end_inset |
|
|
|
|
|
\end_float |
|
After that, click |
|
\begin_inset Quotes eld |
|
\end_inset |
|
|
|
straighten |
|
\begin_inset Quotes erd |
|
\end_inset |
|
|
|
. |
|
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 |
|
|
|
\begin_float fig |
|
\layout Standard |
|
\align center |
|
|
|
\begin_inset Figure size 264 245 |
|
file mapInsertResource.eps |
|
flags 9 |
|
|
|
\end_inset |
|
|
|
|
|
\layout Caption |
|
|
|
Inserting a Resource |
|
\begin_inset LatexCommand \label{Inserting a Resource Figure} |
|
|
|
\end_inset |
|
|
|
|
|
\end_float |
|
To insert a resource into the flow, click the black line with two arrows. |
|
In the secondary window, you'll see something like figure |
|
\begin_inset LatexCommand \ref{Inserting a Resource Figure} |
|
|
|
\end_inset |
|
|
|
. |
|
Click |
|
\series bold |
|
Insert Resource Into Link |
|
\series default |
|
. |
|
A new resource will appear in the link. |
|
Click the resource. |
|
\layout Enumerate |
|
|
|
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 61 360 |
|
file mapEditorResourceChosen.eps |
|
flags 9 |
|
|
|
\end_inset |
|
|
|
|
|
\layout Caption |
|
|
|
Resource Chosen |
|
\begin_inset LatexCommand \label{Map Resource Chosen Figure} |
|
|
|
\end_inset |
|
|
|
|
|
\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 |
|
into the secondary window, 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 |
|
|
|
Repeat steps two and three for as many resources as you'd like to bind together |
|
into one page. |
|
You can insert the new resources anywhere you'd like. |
|
\layout Enumerate |
|
|
|
When you are done adding resources, click the |
|
\series bold |
|
Save Map |
|
\series default |
|
link to save the map. |
\layout Subsection |
\layout Subsection |
|
|
Detailed number problem info |
Creating Sequences |
|
\begin_inset LatexCommand \index{Sequence} |
|
|
|
\end_inset |
|
|
|
|
|
\layout Standard |
|
|
|
Sequences are 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. |
|
Sequence maps are created identically to page maps, the only difference |
|
is how they are displayed. |
\layout Subsection |
\layout Subsection |
|
|
Detailed formula problem info |
Creating a Course: Top-level Sequence |
|
\layout Standard |
|
|
|
In order to view sequences, they need to be part of a |
|
\series bold |
|
course |
|
\series default |
|
. |
|
\begin_float fig |
|
\layout Standard |
|
\align center |
|
|
|
\begin_inset Figure size 422 410 |
|
file creatingANewCourse.eps |
|
flags 9 |
|
|
|
\end_inset |
|
|
|
|
|
\layout Caption |
|
|
|
Creating a New Course |
|
\begin_inset LatexCommand \label{Creating a New Course Figure} |
|
|
|
\end_inset |
|
|
|
|
|
\end_float |
|
Courses have a Top-level Map which defines the whole course. |
|
This top-level map will often itself contain maps corresponding to homework |
|
assignments or weekly sequences. |
|
To view your maps, you will need to make them part of a course. |
|
Only Domain Administrators can make courses and set their Top-level maps, |
|
so coordinate with your Domain Adminstrator if you need to create courses. |
|
\layout Section |
|
|
|
Numerical Response |
|
\begin_inset LatexCommand \index{Numerical Response} |
|
|
|
\end_inset |
|
|
|
|
|
\begin_inset LatexCommand \label{Numerical Response} |
|
|
|
\end_inset |
|
|
|
And Formula Response Questions |
|
\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 |
\layout Subsection |
|
|
My questions\SpecialChar \ldots{} |
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 Itemize |
|
|
|
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 |
|
|
|
With variables, you can store strings or numbers. |
|
|
|
\series bold |
|
Functions |
|
\series default |
|
allow you to manipulate these strings or numbers. |
|
By stringing together a series of functions, you can do a lot. |
|
\layout Standard |
|
|
|
|
|
\series bold |
|
Functions |
|
\series default |
|
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_float fig |
|
\layout LyX-Code |
|
|
|
$a = 3; |
|
\layout LyX-Code |
|
|
|
$b = &sin($a); |
|
\layout LyX-Code |
|
|
|
$c = &pow(3, &floor($a)); |
|
\layout Caption |
|
|
|
Some Function Calls |
|
\begin_inset LatexCommand \label{Some Function Calls Figure} |
|
|
|
\end_inset |
|
|
|
|
|
\end_float |
|
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 |
|
floor |
|
\family default |
|
returns the nearest integer below the parameter, which since 3 is already |
|
an integer is 3. |
|
\layout Subsubsection |
|
|
|
Randomization |
|
\begin_inset LatexCommand \index{Randomization} |
|
|
|
\end_inset |
|
|
|
|
|
\layout Standard |
|
|
|
For LON-CAPA, one of the most importent 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 |
|
&rand(1,2,.2) |
|
\family default |
|
might return 1, 1.2, 1.4, 1.6, 1.8, or 2. |
|
|
|
\layout Standard |
|
|
|
\begin_float fig |
|
\layout LyX-Code |
|
|
|
$a = &random(1,10,1); |
|
\layout LyX-Code |
|
|
|
$b = &random(-10, -3, 1); |
|
\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_float |
|
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. |
|
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 guarenteed 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 |
|
|
|
Dynamic, Randomized Problems: Putting It All Together |
|
\layout Standard |
|
|
|
Now you have all the tools to create those wonderful dynamic, randomized |
|
problems that you've seen in LON-CAPA. |
|
\begin_float fig |
|
\layout Standard |
|
\align center |
|
|
|
\begin_inset Figure size 476 197 |
|
file numericalResponseSlopeProblem.eps |
|
width 3 80 |
|
flags 9 |
|
|
|
\end_inset |
|
|
|
|
|
\layout Caption |
|
|
|
Slope Problem Parameters |
|
\begin_inset LatexCommand \label{Slope Problem Parameters Figure} |
|
|
|
\end_inset |
|
|
|
|
|
\end_float |
|
For example, try filling out your problem with the parameters shown in |
|
figure |
|
\begin_inset LatexCommand \ref{Slope Problem Parameters Figure} |
|
|
|
\end_inset |
|
|
|
. |
|
|
|
\layout Standard |
|
|
|
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 |
|
&rand(-1,1,.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 Standard |
|
|
|
LON-CAPA has functions for several common random distributions; consult |
|
the function list at http://mileva.lite.msu.edu/loncapadocs/homework/homework5.html |
|
for a complete list and parameter specification. |
|
\layout Subsection |
|
|
|
Units, Format |
|
\layout Standard |
|
|
|
Numerical Response problems can require units. |
|
In the problem editting form, place the desired unit in the |
|
\series bold |
|
Unit |
|
\series default |
|
field. |
|
For information about what units the system accepts, see http://capa4.lite.msu.edu |
|
/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 |
|
|
|
as correct. |
|
\layout Standard |
|
|
|
Additionally, you can format the number displayed by the computer as the |
|
answer. |
|
For instance, if the answer is one-third, the computer will display that |
|
it computed |
|
\begin_inset Quotes eld |
|
\end_inset |
|
|
|
.333333333 |
|
\begin_inset Quotes erd |
|
\end_inset |
|
|
|
as the answer. |
|
If you'd like to shorten that, you can use the |
|
\series bold |
|
Format |
|
\series default |
|
field. |
|
Format strings like |
|
\begin_inset Quotes eld |
|
\end_inset |
|
|
|
2e |
|
\begin_inset Quotes erd |
|
\end_inset |
|
|
|
(without the quotes) will display three significant digits in scientific |
|
notation. |
|
Format strings like |
|
\begin_inset Quotes eld |
|
\end_inset |
|
|
|
2f |
|
\begin_inset Quotes erd |
|
\end_inset |
|
|
|
will display three significant digit in traditional notation. |
|
You can use any number that you want instead of |
|
\begin_inset Quotes eld |
|
\end_inset |
|
|
|
2 |
|
\begin_inset Quotes erd |
|
\end_inset |
|
|
|
. |
|
\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. |
|
You may also find new ideas you can use and elaborate on 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. |
|
Looking in the function list at http://mileva.lite.msu.edu/loncapadocs/homework/ho |
|
mework5.html can give you some ideas. |
|
O'Reilly has some good Perl books. |
|
The Perl 5 pocket reference will contain more then what you need to know |
|
to use LON-CAPA, available at 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 emailing us your question so we can answer it. |
|
\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 |
|
\begin_inset LatexCommand \index{Formula Response} |
|
|
|
\end_inset |
|
|
|
|
|
\begin_inset LatexCommand \label{Formula Response} |
|
|
|
\end_inset |
|
|
|
Problems |
|
\layout Standard |
|
|
|
\begin_float fig |
|
\layout Standard |
|
\align center |
|
|
|
\begin_inset Figure size 476 262 |
|
file formulaResponse.eps |
|
width 3 80 |
|
flags 9 |
|
|
|
\end_inset |
|
|
|
|
|
\layout Caption |
|
|
|
Formula Response Problem |
|
\end_float |
|
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 |
|
\end_inset |
|
|
|
2*x*x+4 |
|
\begin_inset Quotes erd |
|
\end_inset |
|
|
|
, |
|
\begin_inset Quotes eld |
|
\end_inset |
|
|
|
x*x + x*x + 4 |
|
\begin_inset Quotes erd |
|
\end_inset |
|
|
|
, |
|
\begin_inset Quotes eld |
|
\end_inset |
|
|
|
2*x^2 + 14 - 10 |
|
\begin_inset Quotes erd |
|
\end_inset |
|
|
|
, 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 |
|
|
|
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 |
|
|
|
? Symbolically proving it one way or another is impossible in general. |
|
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 Comment |
|
|
|
What's up with the x,y@1,2:4,3#2 stuff? |
|
\layout Standard |
|
|
|
Formula Response problems are otherwise virtually identical to Numeric Response |
|
problems. |
|
\layout Subsubsection |
|
|
|
Sample Point Specifications |
|
\begin_inset LatexCommand \index{Sample Points} |
|
|
|
\end_inset |
|
|
|
|
|
\layout Standard |
|
|
|
To specific the sample points, use the following format: |
\layout Itemize |
\layout Itemize |
|
|
How do I do the things above? |
a comma seperated list of the variables you wish to have sampled, |
\layout Itemize |
\layout Itemize |
|
|
Is there any pre-existing documentation for number or formula problems? |
followed by an @ |
\layout Itemize |
\layout Itemize |
|
|
Is there any pre-existing documentation for maps et al? I seem to have exhausted |
followed by a comma seperated list of values as long as your list of variables, |
the documentation. |
representing the sample points |
|
\layout Itemize |
|
|
|
optionally followed by a semi-colon, and more comma seperated lists as in |
|
the previous item. |
|
\layout Standard |
|
|
|
For |
|
\begin_inset Formula \( 2x^{2}+4 \) |
|
\end_inset |
|
|
|
, with one variable |
|
\begin_inset Quotes eld |
|
\end_inset |
|
|
|
x |
|
\begin_inset Quotes erd |
|
\end_inset |
|
|
|
, one could specify |
|
\begin_inset Quotes eld |
|
\end_inset |
|
|
|
x@2 |
|
\begin_inset Quotes erd |
|
\end_inset |
|
|
|
or |
|
\begin_inset Quotes eld |
|
\end_inset |
|
|
|
x@2;3;4;5 |
|
\begin_inset Quotes erd |
|
\end_inset |
|
|
|
. |
|
(It is generally a good idea to give a few sample points.) For |
|
\begin_inset Formula \( 2y^{3}+2x \) |
|
\end_inset |
|
|
|
, with two variables, one could specify |
|
\begin_inset Quotes eld |
|
\end_inset |
|
|
|
x,y@1,2;1,3;2,3;2,2 |
|
\begin_inset Quotes erd |
|
\end_inset |
|
|
|
. |
|
|
|
\layout Subsubsection |
|
|
|
Example Formula Response |
|
\layout Standard |
|
|
|
A very simple formula response problem: |
|
\layout Standard |
|
|
|
In the |
|
\series bold |
|
Script |
|
\series default |
|
, place the following: |
|
\layout LyX-Code |
|
|
|
$slope = random(1,5,.5); |
|
\layout LyX-Code |
|
|
|
$yint = random(1,5,.5); |
|
\layout Standard |
|
|
|
In the |
|
\series bold |
|
Text Block |
|
\series default |
|
, place the following: |
|
\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 |
|
|
|
|
|
\layout Standard |
|
|
|
In the |
|
\series bold |
|
Answer |
|
\series default |
|
, place the following: |
|
\begin_inset Quotes eld |
|
\end_inset |
|
|
|
$slope*x + $yint |
|
\begin_inset Quotes erd |
|
\end_inset |
|
|
|
|
|
\layout Standard |
|
|
|
Set the Tolerence to 1%. |
|
\layout Standard |
|
|
|
Set the |
|
\series bold |
|
Answer |
|
\series default |
|
to |
|
\begin_inset Quotes eld |
|
\end_inset |
|
|
|
$slope * x + $yint |
|
\begin_inset Quotes erd |
|
\end_inset |
|
|
|
. |
|
\layout Standard |
|
|
|
Set the |
|
\series bold |
|
Sample Points |
|
\series default |
|
to x@0,1,2,3 . |
|
\layout Section |
|
|
|
Things That Need To Be Added |
|
\layout Subsection |
|
|
|
Creating a default metadata file |
|
\layout Subsection |
|
|
|
My questions\SpecialChar \ldots{} |
|
|
\layout Itemize |
\layout Itemize |
|
|
What is the LON-CAPA default resource? If it's free, can just anyone |
What is the LON-CAPA default resource? If it's free, can just anyone |
Line 2764 use it if they already know where it is
|
Line 4570 use it if they already know where it is
|
|
|
? (In other words, how powerful is the search feature?) What's the difference |
? (In other words, how powerful is the search feature?) What's the difference |
between free and public? |
between free and public? |
|
\layout Itemize |
|
|
|
How do I look at a map? (Must be part of course?) |
\layout Section |
\layout Section |
|
|
Appendix A: Student Interface |
Appendix A: Student Interface |