--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/using_sage_to_teach/script.rst Fri Oct 08 23:55:07 2010 +0530
@@ -0,0 +1,181 @@
+.. Objectives
+.. ----------
+
+.. A - Students and teachers from Science and engineering backgrounds
+ B -
+ C -
+ D -
+
+.. Prerequisites
+.. -------------
+
+.. 1. Getting started with lists
+
+.. Author : Nishanth Amuluru
+ Internal Reviewer :
+ External Reviewer :
+ Checklist OK? : <put date stamp here, if OK> [2010-10-05]
+
+Script
+------
+
+Hello friends and welcome to the tutorial on "Using SAGE to teach"
+
+{{{ Show the slide containing title }}}
+
+{{{ Show the slide containing the outline slide }}}
+
+In this tutorial, we shall learn
+
+ * How to use the "@interact" feature of SAGE for better demonstration
+ * How to use SAGE for collaborative learning
+
+Let us look at a typical example of demonstrating a damped oscillation.
+::
+
+ t = var('t')
+ p1 = plot( e^(-t) * sin(2*t), (t, 0, 15))
+ show(p1)
+
+Now let us reduce the damping factor
+::
+
+ t = var('t')
+ p1 = plot( e^(-t/2) * sin(2*t), (t, 0, 15))
+ show(p1)
+
+Now if we want to reduce the damping factor even more, we would be using
+e^(-t/3). We can observe that every time we have to change, all we do is change
+something very small and re evaluate the cell.
+
+This process can be automated using the ``@interact`` feature of SAGE.
+
+::
+
+ @interact
+ def plot_damped(n=1):
+ t = var('t')
+ p1 = plot( e^(-t/n) * sin(2*t), (t, 0, 20))
+ show(p1)
+
+We can see that the function is evaluated and the plot is shown. We can also
+see that there is a field to enter the value of ``n`` and it is currently set
+to ``1``. Let us change it to 2 and hit enter.
+
+We see that the new plot with reduced damping factor is shown. Similarly we can
+change ``n`` to any desired value and hit enter and the function will be
+evaluated.
+
+This is a very handy tool while demonstrating or teaching.
+
+{{{ Pause here and try out the following exercises }}}
+
+%% 1 %% Plot the sine curve and vary its frequency using the ``@interact``
+
+{{{ continue from paused state }}}
+
+::
+
+ @interact
+ def sine_plot(n=1):
+ x = var('x')
+ p2 = plot(sin(n*x), (x, 0, 2*pi))
+ show(p2)
+
+Often we would want to vary a parameter over range instead of taking it as an
+input from the user. For instance we do not want the user to give ``n`` as 0
+for the damping oscillation we discussed. In such cases we use a range of
+values as the default argument.
+::
+
+ @interact
+ def plot_damped(n=(1..10)):
+ t = var('t')
+ p1 = plot( e^(-t/n) * sin(2*t), (t, 0, 20))
+ show(p1)
+
+We get similar plot but the only difference is the input widget. Here it is a
+slider unlike an input field. We can see that as the slider is moved, the
+function is evaluated and plotted accordingly.
+
+{{{ Pause here and try out the following exercises }}}
+
+%% 2 %% Take a string as input from user and circular shift it to the left and
+ vary the shift length using a slider
+
+{{{ continue from paused state }}}
+
+::
+
+ @interact
+ def str_shift(s="MADAM", shift=(0..8)):
+ shift_len = shift % len(s)
+ chars = list(s)
+ shifted_chars = chars[shift_len:] + chars[:shift_len]
+ print "Actual String:", s
+ print "Shifted String:", "".join(shifted_chars)
+
+Sometimes we want the user to have only a given set of options. We use a list
+of items as the default argument in such situations.
+::
+
+ @interact
+ def str_shift(s="STRING", shift=(0..8), direction=["Left", "Right"]):
+ shift_len = shift % len(s)
+ chars = list(s)
+ if direction == "Right":
+ shifted_chars = chars[-shift_len:] + chars[:-shift_len]
+ else:
+ shifted_chars = chars[shift_len:] + chars[:shift_len]
+ print "Actual String:", s
+ print "Shifted String:", "".join(shifted_chars)
+
+We can see that buttons are displayed which enables us to select from a given
+set of options.
+
+We have learnt how to use the ``@interact`` feature of SAGE for better
+demonstration. We shall look at how to use SAGE worksheets for collaborative
+learning.
+
+The first feature we shall see is the ``publish`` feature. Open a worksheet and
+in the top right, we can see a button called ``publish``. Click on that and we
+get a confirmation page with an option for re publishing.
+
+For now lets forget that opion and simply publish by cliking ``yes``. The
+worksheet is now published.
+
+Now lets signout and go to the sage notebook home. We see link to browse
+published worksheets. Lets click on it and we can see the worksheet. This does
+not require login and anyone can view the worksheet.
+
+Alternatively, if one wants to edit the sheet, there is a link on top left
+corner that enables the user to download a copy of the sheet onto their home.
+This way they can edit a copy of the worksheet.
+
+We have learnt how to publish the worksheets to enable users to edit a copy.
+Next, we shall look at how to enable users to edit the actual worksheet itself.
+
+Let us open the worksheet and we see a link called ``share`` on the top right
+corner of the worksheet. Click the link and we get a box where we can type the
+usernames of users whom we want to share the worksheet with. We can even
+specify multiple users by seperating their names using commas. Once we have
+shared the worksheet, the worksheet appears on the home of shared users.
+
+{{{ Show summary slide }}}
+
+This brings us to the end of the tutorial.
+we have learnt
+
+ * How to user interactive feaures of SAGE
+ * How to publish our work
+ * How to edit a copy of one of the published worksheets
+ * How to share the worksheets with fellow users
+
+{{{ Show the "sponsored by FOSSEE" slide }}}
+
+#[Nishanth]: Will add this line after all of us fix on one.
+This tutorial was created as a part of FOSSEE project, NME ICT, MHRD India
+
+Hope you have enjoyed and found it useful.
+Thankyou
+