added script to using_sage_to_teach

3 files changed, 298 insertions, 0 deletions

diff --git a/using_sage_to_teach/quickref.tex b/using_sage_to_teach/quickref.tex
new file mode 100644
index 0000000..a0212b3
--- /dev/null
+++ b/using_sage_to_teach/quickref.tex
@@ -0,0 +1,11 @@
+Creating a tuple:\\
+{\ex \lstinline|    t = (1, "hello", 2.5)|}
+
+Accessing elements of tuples:\\
+{\ex \lstinline|    t[index] Ex: t[2]|}
+
+Accessing slices of tuples:\\
+{\ex \lstinline|    t[start:stop:step]|}
+
+Swapping values:\\
+{\ex \lstinline|    a, b = b, a|}
diff --git a/using_sage_to_teach/script.rst b/using_sage_to_teach/script.rst
new file mode 100644
index 0000000..0316a31
--- /dev/null
+++ b/using_sage_to_teach/script.rst
@@ -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
+
diff --git a/using_sage_to_teach/slides.tex b/using_sage_to_teach/slides.tex
new file mode 100644
index 0000000..df1462c
--- /dev/null
+++ b/using_sage_to_teach/slides.tex
@@ -0,0 +1,106 @@
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%Tutorial slides on Python.
+%
+% Author: FOSSEE 
+% Copyright (c) 2009, FOSSEE, IIT Bombay
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+
+\documentclass[14pt,compress]{beamer}
+%\documentclass[draft]{beamer}
+%\documentclass[compress,handout]{beamer}
+%\usepackage{pgfpages} 
+%\pgfpagesuselayout{2 on 1}[a4paper,border shrink=5mm]
+
+% Modified from: generic-ornate-15min-45min.de.tex
+\mode<presentation>
+{
+  \usetheme{Warsaw}
+  \useoutertheme{infolines}
+  \setbeamercovered{transparent}
+}
+
+\usepackage[english]{babel}
+\usepackage[latin1]{inputenc}
+%\usepackage{times}
+\usepackage[T1]{fontenc}
+
+\usepackage{ae,aecompl}
+\usepackage{mathpazo,courier,euler}
+\usepackage[scaled=.95]{helvet}
+
+\definecolor{darkgreen}{rgb}{0,0.5,0}
+
+\usepackage{listings}
+\lstset{language=Python,
+    basicstyle=\ttfamily\bfseries,
+    commentstyle=\color{red}\itshape,
+  stringstyle=\color{darkgreen},
+  showstringspaces=false,
+  keywordstyle=\color{blue}\bfseries}
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+% Macros
+\setbeamercolor{emphbar}{bg=blue!20, fg=black}
+\newcommand{\emphbar}[1]
+{\begin{beamercolorbox}[rounded=true]{emphbar} 
+      {#1}
+ \end{beamercolorbox}
+}
+\newcounter{time}
+\setcounter{time}{0}
+\newcommand{\inctime}[1]{\addtocounter{time}{#1}{\tiny \thetime\ m}}
+
+\newcommand{\typ}[1]{\lstinline{#1}}
+
+\newcommand{\kwrd}[1]{ \texttt{\textbf{\color{blue}{#1}}}  }
+
+% Title page
+\title{Your Title Here}
+
+\author[FOSSEE] {FOSSEE}
+
+\institute[IIT Bombay] {Department of Aerospace Engineering\\IIT Bombay}
+\date{}
+
+% DOCUMENT STARTS
+\begin{document}
+
+\begin{frame}
+  \maketitle
+\end{frame}
+
+\begin{frame}[fragile]
+  \frametitle{Outline}
+  \begin{itemize}
+    \item 
+  \end{itemize}
+\end{frame}
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%%              All other slides here.                  %%
+%% The same slides will be used in a classroom setting. %% 
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+
+\begin{frame}[fragile]
+  \frametitle{Summary}
+  \begin{itemize}
+    \item 
+  \end{itemize}
+\end{frame}
+
+\begin{frame}
+  \frametitle{Thank you!}  
+  \begin{block}{}
+  \begin{center}
+  This spoken tutorial has been produced by the
+  \textcolor{blue}{FOSSEE} team, which is funded by the 
+  \end{center}
+  \begin{center}
+    \textcolor{blue}{National Mission on Education through \\
+      Information \& Communication Technology \\ 
+      MHRD, Govt. of India}.
+  \end{center}  
+  \end{block}
+\end{frame}
+
+\end{document}