summary |
shortlog |
changelog |
graph |
tags |
bookmarks |
branches |
files |
changeset |
file |
latest |
revisions |
annotate |
diff |
comparison |
raw |
help

using_sage_to_teach/script.rst

author | anand |

Mon, 15 Nov 2010 14:54:10 +0530 | |

changeset 502 | 8ca74cb15807 |

parent 501 | 2c30d4a242ee |

permissions | -rw-r--r-- |

checklist not ok; 5 short answer questions and 2 long answer questions
are to be included.

.. Objectives .. ---------- .. By the end of this tutorial you will be able to .. * use ``@interact`` feature of SAGE .. * learn to share, publish and edit SAGE worksheets .. Prerequisites .. ------------- .. 1. Getting started with lists .. Author : Nishanth Amuluru Internal Reviewer : External Reviewer : Language Reviewer : Bhanukiran Checklist OK? : <put date stamp here, not OK> [2010-10-05] Script ------ {{{ Show the slide containing title }}} Hello friends and welcome to the tutorial on Using SAGE to teach {{{ 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 simplified, 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 option and simply publish by clicking ``yes``. The worksheet is now published. Now lets sign out 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 }}} This tutorial was created as a part of FOSSEE project, NME ICT, MHRD India Hope you have enjoyed and found it useful. Thank you!