Added documentation to ULT

18 files changed, 478 insertions, 0 deletions

diff --git a/ult/Documentation/5.1.rst b/ult/Documentation/5.1.rst
new file mode 100644
index 0000000..049309f
--- /dev/null
+++ b/ult/Documentation/5.1.rst
@@ -0,0 +1,43 @@
+
+5.1 Getting started with Sage notebook
+======================================
+
+1. Know about Sage
+   * What is Sage(0.30 - 0.52)
+   * Installing Sage(0.53 - 1.11)
+
+#. Start Sage shell (1.18 - 1.35)
+
+#. What is sage notebook and how to start the same (1.35 - 2.44)
+   
+#. Create accounts and start using the notebook(2.45 - 4.13)
+
+#. Access the menus available on the notebook(4.15 - 5.07)
+
+#. Create new worksheets(5.08 - 5.30)
+
+#. Evaluate cells in the worksheet(5.31 - 6.20)
+  
+#. Create new cells, delete the cells and navigate around the cells
+   * Creating new cells(6.21 - 6.45)
+   * Evaluating cells(6.45 - 7.21)
+   * Navigating around cells(7.22 - 7.35)
+   * Deleting cells(7.36 - 7.40)
+
+#. Make annotations in the worksheet(7.41 - 7.58)
+
+#. Embed code of other scripting languages in the cells
+   * HTML(7.59 - 9.27)
+   * Latex(9.28 - 9.59)
+
+#. Obtaining help and using tab completions
+   * help(10.01 - 10.46)
+   * tab completion(10.47 - 11.44)
+   * The three states(11.47 - 14.33)
+
+#. Summary(14.37 - 15.02)
+
+#. Evaluation Questions(15.04 - 15.34)
+
+
+
diff --git a/ult/Documentation/5.2.rst b/ult/Documentation/5.2.rst
new file mode 100644
index 0000000..d76e832
--- /dev/null
+++ b/ult/Documentation/5.2.rst
@@ -0,0 +1,32 @@
+
+5.2 Getting started with symbolics
+==================================
+
+1. Define symbolic expressions in sage(0.29 - 2.52)
+   * Exercise 1: Define given expressions as symbolic expressions(3.03 - 3.44)
+
+#. Use built-in constants and functions
+   * built-in constants(3.46 - 4.59)
+   * built-in functions(5.00 - 6.02)
+   * Exercise 2: Combined problem of built-in constants and functions(6.06 - 7.00)
+
+#. Define Symbolic functions
+   * Define arbitary functions(7.03 - 8.09)
+   * Define functions piecewise(8.10 - 9.19)
+   * Define functions convergent series & other series(9.20 - 11.37)
+   * Exercise 3:Define a piecewise function(11.43 - 12.57)
+
+#. Perform calculus using sage
+   * Differentiation(12.58 - 14.36)
+   * Integration(14.37 - 15.16)
+   * Find factors(15.17 - 15.45)
+   * Simplify(15.46 - 16.31)
+   * Find roots and substitute(16.32 - 18.02)
+   * Exercise 4: Perform calculus on given expressions(18.07 - 19.51)
+
+#. Matrices in Sage(19.52 - 20.56) 
+   * Exercise 5: Find the determinant and inverse of the given expression(20.57 - 21.43)
+
+#. Summary(21.46 - 22.27)
+
+#. Evaluation Questions(22.28 - 23.2s1) 
diff --git a/ult/Documentation/5.3.rst b/ult/Documentation/5.3.rst
new file mode 100644
index 0000000..098d0ab
--- /dev/null
+++ b/ult/Documentation/5.3.rst
@@ -0,0 +1,20 @@
+
+5.3 Using Sage
+==============
+
+1. Use functions for calculus(0.22 - 7.35)
+   * limits(0.30 - 1.46)
+   * differentiation(1.46 - 3.48)
+   * integration(3.50 - 5.14)
+   * taylor series(5.15 - 5.59)
+   * Matrix algebra(5.60 - 7.35)
+
+#. Create graphs(7.36 - 9.24)
+   * Simple graph(7.43 - 8.23)
+   * Directed graph(8.23 - 9.24)
+
+#. Use functions for Number theory(9.26 - 11.21)
+
+#. Summary(11.28 - 12.20)
+
+#. Evaluation Questions(12.21 - 14.02)
diff --git a/ult/Documentation/5.4.rst b/ult/Documentation/5.4.rst
new file mode 100644
index 0000000..69ac8a8
--- /dev/null
+++ b/ult/Documentation/5.4.rst
@@ -0,0 +1,20 @@
+
+5.4 Using Sage to teach
+=======================
+
+1. Use interactive features of SAGE(0.28 - 3.43)
+   * Exercise 1(3.48 - 4.44)
+   * use a range of values as default arguments(4.44 - 6.46)
+   * Exercise 2(6.50 - 8.39)
+   * use a list of items as default arguments(8.40 - 11.16)
+
+#. Publish our work(11.28 - 12.15)
+
+#. Edit a copy of one of the published worksheets(12.16 - 12.38)
+
+#. Share the worksheets with fellow users(12.44 - 13.19)
+
+#. Summary(13.23 - 13.36)
+
+#. Evaluation Questions(13.38 - 14.54)
+
diff --git a/ult/Documentation/6.1.rst b/ult/Documentation/6.1.rst
new file mode 100644
index 0000000..fbb28bd
--- /dev/null
+++ b/ult/Documentation/6.1.rst
@@ -0,0 +1,51 @@
+
+6.1 Basic Data types and operators
+==================================
+
+1. Understand the number Datatypes(0.28-231)
+   * int(0.50 - 2.15)
+   * float(2.16 - 3.04)
+   * complex(3.05 - 4.05)
+   * Exercise 1: Find the absolute value of the given complex number(4.10 - 4.35)
+   * Exercise 2: Find the datatype of the given number(4.44 - 5.11)
+   
+
+#. Know the boolean datatype and operators -- +, *, /, **, % .
+   * Boolean(5.12 - 7.02)
+   * Operators(7.03 - 9.20)
+   * Exercise 3: Find square root of the given number(9.25 - 9.37)
+   * Exercise 4: Compare two expressions(9.38 - 10.23)
+
+
+#. Use the sequence data types -- List,String and Tuple
+   * What are Sequence data types(10.24 - 10.41)
+   * List(10.42 - 11.44)
+   * Strings(11.45 - 12.53)
+   * Tuples(12.54 - 3.12)
+
+#. Some imporant functions & methods
+   * Accessing(3.17 - 14.25)
+   * Addition(14.26 - 15.17)
+   * ``len'' function(15.18 - 15.45)
+   * Containership(15.45 - 16.18)
+   * max and min functions(16.18 - 16.38)
+   * get a sorted list(16.39 - 16.49)
+
+#. Slice sequences by using the row and column numbers.
+   * Slicing(16.50 - 18.31)
+   * Striding(18.32 - 19.24)
+
+#. Convert one data type to other
+   * Convert string to tuple and vice-versa(19.25 - 20.33)
+   * Convert one number type data structure to another(20.34 - 22.08)
+  
+#. Split and join a list using ``split()`` and ``join()`` function respectively
+   * ``split()'' and ``join()'' functions(22.09 - 25.31)
+   * Exercise 5: Check if the given number is an element of a list(25.38 - 26.21)
+   * Exercise 6: Converting a string(26.31 - 27.09)
+
+#. Summary(27.13 - 27.52)
+
+#. Evaluation Questions(27.53 - 28.28)
+
+
diff --git a/ult/Documentation/6.2.rst b/ult/Documentation/6.2.rst
new file mode 100644
index 0000000..5f71f85
--- /dev/null
+++ b/ult/Documentation/6.2.rst
@@ -0,0 +1,23 @@
+
+6.2 Input Output
+================
+
+1. Print some value(0.26 - 1.58)
+   
+#. Print using modifiers
+   * Using modifiers(1.59 - 3.01)
+   * Exercise 1(3.06 - 3.57)
+   * Another example using print(3.58 - 5.43)
+
+#. Take input from user
+    * raw_input(5.44 - 6.49)
+    * Exercise 2(6.58 - 7.53)
+    * Exercise 3(7.59 - 8.30)
+
+#. Display a prompt to the user before taking the input
+    * Display a prompt(8.31 - 8.53)
+    * Exercise 4(8.58 - 9.33)
+
+#. Summary(9.38 - 10.02)
+
+#. Evaluation Questions(10.04 - 11.22)
diff --git a/ult/Documentation/6.3.rst b/ult/Documentation/6.3.rst
new file mode 100644
index 0000000..03becb9
--- /dev/null
+++ b/ult/Documentation/6.3.rst
@@ -0,0 +1,18 @@
+
+6.3 Conditionals
+================
+
+1. Use if/else blocks(0.34 - 2.24)
+
+#. Use if/elif/else blocks(2.25 - 5.51)
+   * Exercise 1: Write an if else block for the given condition(5.56 - 6.28)
+
+#. Use the Ternary conditional statement - C if X else Y(6.29 - 7.52)
+   * Exercise 2: Write a ternary operator for the given problem(7.53 - 8.20)
+
+#. Use of ``pass'' statement(8.21 - 9.55)
+
+#. Summary(9.58 - 10.15)
+
+#. Evaluation Questions(10.18 - 11.16)
+
diff --git a/ult/Documentation/6.4.rst b/ult/Documentation/6.4.rst
new file mode 100644
index 0000000..0c84f08
--- /dev/null
+++ b/ult/Documentation/6.4.rst
@@ -0,0 +1,20 @@
+
+6.4 Loops
+=========
+
+1. Use the ``while`` loop(0.30 - 1.40)
+   * Exercise 1: Write a while loop for the given problem(1.45 - 2.25)
+
+#. Use the ``for`` loop(2.26 - 3.11)
+   * Exercise 2: Write a for loop for the given problem(3.17 - 3.45)
+
+#. Use ``break``, ``continue`` and ``pass`` statements to play around with loops(3.46 -)
+   * pass(3.51 - 4.20)
+   * break(4.20 - 5.41)
+   * continue(5.42 - 6.35)
+   * Exercise 3: Write a for loop using ``continue'' keyword(6.40 - 7.29)
+
+#. Summary(7.31 - 7.45)
+
+#. Evaluation Questions(7.48 - 8.35)
+
diff --git a/ult/Documentation/7.1.rst b/ult/Documentation/7.1.rst
new file mode 100644
index 0000000..ae746e0
--- /dev/null
+++ b/ult/Documentation/7.1.rst
@@ -0,0 +1,28 @@
+
+7.1 Manipulatin12.30g Lists
+======================
+
+1. Slicing
+   * Perform slicing on a list(0.33 - 2.26)
+   * Exercise 1: Obtain the primes less than 10, from the given list(2.34 - 2.58)
+   * Start and stop index in slicing(3.00 - 5.29)
+   * Exercise 2:Obtain all the multiples of three from the given list(5.47 - 6.10)
+
+#. Concatenate two lists
+   * Using the plus operator(6.12 - 7.12)
+
+#. Sorting lists
+   * Using the ``sort'' method(7.13 - 8.01)
+   * Using the ``sorted'' method(8.02 - 8.56)
+
+#. Reverse lists
+   * Using the ``reverse'' method(8.58 - 9.28)
+
+#. Striding
+   * Example which performs striding(8.58 - 9.47)
+   * Exercise 3: Obtain a list with marks in descending order from the given list(9.52 - 11.07)
+
+#. Summary(11.10 - 11.23)
+
+#. Evaluation Questions(11.25 - 12.30)
+
diff --git a/ult/Documentation/7.2.rst b/ult/Documentation/7.2.rst
new file mode 100644
index 0000000..5db4c81
--- /dev/null
+++ b/ult/Documentation/7.2.rst
@@ -0,0 +1,29 @@
+
+7.2 Manipulating strings
+========================
+
+1. Slice strings and get sub-strings out of them
+   * Check whether a particular string is valid for the given list(0.45 - 3.00)
+   * Exercise 1: Obtain a sub-string excluding the first and last characters
+                 from the string s(3.08 - 4.10)
+   
+#. Reverse strings.
+   * Finding out, if a given string is palindromic or not(4.11 - 5.24)
+ 
+#.Convert strings to upper or lower case.
+   * Converting a string to lower/upper case(5.25 - 6.49)
+   * Exercise 2: Combined exercise of sub-string and converting strings to upper/lower case(6.56 - 8.01)
+
+#. Replace characters in strings. 
+   * Example of replacing special characters in strings(8.02 - 9.18)
+   * Exercise 3: Replace the ``[dot]`` with ``.``(9.27 - 10.06)
+    
+#. Join a list of strings
+   * Example showing how to obtain one long string of e-mail addresses separated 
+     by commas or semi-colons from a list of e-mail addresses(10.07 - 11.32)
+   * Exercise 4: Change the seperator from a given string(11.39 - 12.29)
+
+#. Summary(12.33 - 12.54)
+
+#. Evaluation Questions(12.56 - 14.10) 
+
diff --git a/ult/Documentation/7.3.rst b/ult/Documentation/7.3.rst
new file mode 100644
index 0000000..fe63fd1
--- /dev/null
+++ b/ult/Documentation/7.3.rst
@@ -0,0 +1,19 @@
+
+7.3 Tuples
+===========
+
+1. What are tuples
+   * Definition with example(0.25 - 1.42)
+   * Differnce between tuples and lists(1.43 - 2.13)
+
+#. Immutability of tuples
+   * Exercise 1: Swap the values of a and b(2.29 - 4.18)
+
+#. Tuple packing and unpacking
+   * Tuple packing(4.19 - 5.01)
+   * Tuple unpacking(5.02 - 5.26)
+
+#. Summary(5.32 - 5.56)
+
+#. Evaluation Questions(5.57 - 7.12) 
+
diff --git a/ult/Documentation/7.4.rst b/ult/Documentation/7.4.rst
new file mode 100644
index 0000000..171fbf8
--- /dev/null
+++ b/ult/Documentation/7.4.rst
@@ -0,0 +1,24 @@
+
+7.4 Dictionaries
+================
+
+1. Create dictionaries
+   * What are dictionaries(0.26 - 0.56)
+   * Creating an empty dictionary(1.06 - 1.31)
+   * Creating a non-empty dictionary(1.32 - 2.51)
+   * Accessing elements in a dictionary(2.52 - 3.55)
+
+#. Add and delete data from dictionaries
+   * Adding new items into dictionaries(4.05 - 4.35)
+   * Deleting items from dictionary(4.36 - 5.28)
+
+#. Check for container-ship of keys(5.29 - 6.05)
+       
+#. Retrieve data from dictionaries(6.06 - 6.44)
+   
+#. Iterate over elements
+   * Exercise 1: Print the keys and values in the dictionary one by one(6.48 - 7.34)
+
+#. Summary(7.38 - 8.09)	
+
+#. Evaluation Questions(8.11 - 9.29)
diff --git a/ult/Documentation/7.5.rst b/ult/Documentation/7.5.rst
new file mode 100644
index 0000000..9d424c8
--- /dev/null
+++ b/ult/Documentation/7.5.rst
@@ -0,0 +1,24 @@
+
+7.5 Sets
+========
+
+1. Create sets from lists
+   * Definition of sets(0.35 - 0.51)
+   * Create a set(0.54 - 1.32)
+   
+#. Perform union, intersection and symmetric difference operations
+   * Perform union on sets(1.33 - 2.49)
+   * Perform intersection on sets(2.50 - 3.03)
+   * Perform difference on sets(3.03 - 3.20)
+   * Obtain symmetric difference(3.21 - 3.44)
+
+#. Check if a set is a subset of other(3.46 - 4.36)
+   
+#. Understand various similarities with lists like length and containership
+   * Iteration on sets(4.37 - 5.02)
+   * Length and containership(5.03 - 5.43)
+   * Exercise 1: List all the duplicates from a given list(5.49 - 7.29)
+
+#. Summary(7.33 - 8.03)
+
+#. Evaluation Questions(8.05 - 9.49)
diff --git a/ult/Documentation/8.1.rst b/ult/Documentation/8.1.rst
new file mode 100644
index 0000000..860f1f7
--- /dev/null
+++ b/ult/Documentation/8.1.rst
@@ -0,0 +1,28 @@
+8.1 getting started with functions
+==================================
+
+1. Define a function(0.40 - 1.08)
+   * Definition of a function(0.23 - 0.42)
+   * Defining and calling a mathematical function(0.48 - 2.18)
+   * Exercise 1: to write a function which calculates the cube of a number(2.19 - 3.04)
+   * Example of a function without arguments(3.05 - 3.56)
+       
+#. Define functions with arguments
+   * Exercise 2: to write a function which calculates the average of 2 numbers(3.57 - 5.05)
+
+#. Docstrings
+   * Know what are docstrings(5.06 - 7.01)
+   * examples of docstrings like avg and f(7.02 - 7.47)
+   * Exercise 3:To add docstring to a function(7.48 - 8.31)
+
+#. Exercise 3:Combined exercise of a function with docstring(8.32 - 10.02)
+
+#. Function return value
+   * How can function return any number of values(10.03 - 10.38)
+
+#. Read Codes
+   * Few code reading exercises(10.39 - 14.12)
+
+#. Summary(14.13 - 14.38)
+
+#. Evaluation Questions(14.39 - 15.48)
diff --git a/ult/Documentation/8.2.rst b/ult/Documentation/8.2.rst
new file mode 100644
index 0000000..d5ae3ed
--- /dev/null
+++ b/ult/Documentation/8.2.rst
@@ -0,0 +1,23 @@
+8.2 Advanced features of functions
+==================================
+
+1. Assign default values to arguments
+   * use of function as an example to understand what a
+     default value of an argument means(0.42 - 2.40)
+   
+#. Calling function with their default arguments
+   * An example to explain how a function is called by it's arguments(2.41 - 4.01)
+   * Exercise 1: Redifine a function by interchaning it's default arguments(4.06 - 4.51)
+   * Exercise 2: make a note of all the arguments with default values for 'linspace'(4.57 - 5.28)
+   * Exercise 3: Call a function without any arguments(5.34 - 6.18)
+
+#. Define and call functions with keyword arguments
+   * Explanation with examples of keyword arguments(6.19 - 8.28)
+   
+#. Built-in functions available in Python standard library and the scientific computing libraries
+   * What are built-in functions(8.36 - 9.07) 
+   * Classes of functions in pylab, scipy(9.08 - 9.44)
+
+#. Summary(9.45 - 10.02)
+
+#. Evaluation Questions(10.03 - 11.34)
diff --git a/ult/Documentation/8.3.rst b/ult/Documentation/8.3.rst
new file mode 100644
index 0000000..5178881
--- /dev/null
+++ b/ult/Documentation/8.3.rst
@@ -0,0 +1,20 @@
+
+8.3 Using Python Modules
+========================
+
+1. Execute python scripts from command line
+   * An example to show how a script can be executed from the command line (0.31 - 2.17)
+   * Syntax to perform the execution (2.18 - 2.25)
+   
+#. Import modules
+   * Example to import scipy and pylab module (2.26 - 5.28)
+   * Better way of importing (5.29 - 7.54)
+   * Exercise 1: plot a sine wave from minus two pi to two pi(7.59 - 9.02)
+   
+#. Use python standard modules and 3rd party modules
+   * what is a module (9.04 - 9.22)
+   * Python standard library(9.23 - 10.30)
+
+#. Summary(10.34 - 10.51)
+
+#. Evaluation Questions(10.53 - 12.15)
diff --git a/ult/Documentation/8.4.rst b/ult/Documentation/8.4.rst
new file mode 100644
index 0000000..bc00a2b
--- /dev/null
+++ b/ult/Documentation/8.4.rst
@@ -0,0 +1,15 @@
+
+8.4 Writing Python scripts
+==========================
+
+1. What is importing
+   * Definition (0.25 - 0.36)
+   * Example of a gcd function (0.37 - 3.28)
+   * Importing the the gcd function to another location (3.29 - 5.22)
+
+#. Understand the ``__name__=="__main__"`` idiom
+   * How ``__name__=="__main__"`` works (5.23 - 8.06)
+
+#. Summary(8.10 - 8.20)
+
+#. Evaluation Questions(8.21 - 9.31)
diff --git a/ult/Documentation/8.5.rst b/ult/Documentation/8.5.rst
new file mode 100644
index 0000000..02c2353
--- /dev/null
+++ b/ult/Documentation/8.5.rst
@@ -0,0 +1,41 @@
+
+8.5 Testing and debugging
+=========================
+
+1. Understand what is software testing
+   * Definition (0.28 - 0.36)
+   
+#. Test simple functions for their functionality
+   * Example using gcd function (0.37 - 2.19)
+   * Use of __name__ == '__main__': (2.21 - 3.26)
+
+#. Automate tests. 
+   * Exercise 1: Write tests for gcd code (3.42 - 5.14)
+   * Exercise 2: Write automated tests for LCM (5.21 - 5.54)
+
+#. Understand the need for coding style 
+   * What is the need for coding style (6.15 - 6.29)
+   * Naming variables (6.36 - 7.24)  
+   * Code style points (7.26 - 7.59)
+   * Exercise 3: Give meaningful names to the variables in a code(8.04 - 8.21)
+
+#. Handle Errors and Exceptions
+   * Example of an error (8.28 - 9.21)
+   * Use Exception in programs (9.21 - 11.22)
+   * Understand the debugging process (10.33 - 11.52)
+   * How to debug a program in python (11.56 - 13.19)
+
+#. Summary(13.21 - 13.37)
+
+#. Evaluation Questions(13.41 - 14.38)
+
+
+
+
+
+
+
+ 
+ 
+ #. Learn some of the standards followed by the Python Community.
+ .