diff options
| -rw-r--r-- | getting_started_with_sage_notebook/script.rst | 285 | ||||
| -rw-r--r-- | getting_started_with_sage_notebook/slides.org | 99 | ||||
| -rw-r--r-- | getting_started_with_sage_notebook/slides.tex | 136 |
3 files changed, 327 insertions, 193 deletions
diff --git a/getting_started_with_sage_notebook/script.rst b/getting_started_with_sage_notebook/script.rst index fc093d2..128a2e5 100644 --- a/getting_started_with_sage_notebook/script.rst +++ b/getting_started_with_sage_notebook/script.rst @@ -11,7 +11,8 @@ .. #. Be able to create new worksheets .. #. Know about the menu options available .. #. Know about the cells in the worksheet -.. #. Be able to evaluate cells, create and delete cells, navigate them. +.. #. Be able to evaluate cells, create and delete cells, + navigate them. .. #. Be able to make annotations in the worksheet .. #. Be able to use tab completion. .. #. Be able to use code from other languages in the cells. @@ -31,39 +32,48 @@ Script ------ -{{{ Show the slide containing the title }}} +{{{ Show the first slide containing title, name of the production +team along with the logo of MHRD }}} -Hello friends. Welcome to this spoken tutorial on Getting started with -Sage and Sage notebook. +Hello friends and Welcome to this spoken tutorial on "Getting started +with Sage and Sage notebook". -{{{ Show the slide containing the outline }}} +{{{ Show the slide containing objectives }}} -In this tutorial, we will learn what Sage is, what is Sage notebook, -how to start and use the sage notebook. In the notebook we will be -specifically learning how to execute our code, how to write -annotations and other content, typesetting the content and how to use -the offline help available. +At the end of this tutorial, you will be able to, + + #. Know what Sage and Sage notebook are. + #. Start a Sage shell or notebook. + #. Create new worksheets. + #. Know about the menu options available and the cells in the worksheet. + #. Evaluate cells, create and delete cells, navigate them. + #. Make annotations in the worksheet. + #. Use tab completion. + #. Use code from other languages in the cells. + #. Use the offline help available. {{{ Show the slide on what is Sage }}} To start with, What is Sage? Sage is a free, open-source mathematical software. Sage can do a lot of math stuff for you including, but not limited to, algebra, calculus, geometry, cryptography, graph theory -among other things. It can also be used as aid in teaching and +among other things. It can also be used as an aid in teaching and research in any of the areas that Sage supports. So let us start Sage now -{{{ Shift to terminal }}} +{{{ Show slide 'Installing Sage' }}} We are assuming that you have Sage installed on your computer now. If not please visit the page http://sagemath.org/doc/tutorial/introduction.html#installation for the tutorial on how to install Sage. +{{{ Open the terminal }}} -Let us now learn how to start Sage. On the terminal type:: +Let us now learn how to start Sage. On the terminal type +:: - sage + sage This should start a new Sage shell with the prompt sage: which looks like this @@ -72,65 +82,63 @@ like this So now we can type all the commands that Sage supports here. But Sage comes bundled with a much more elegant tool called Sage -Notebook? What is Sage Notebook? Sage Notebook provides a web based +Notebook.So what is Sage Notebook? Sage Notebook provides a web based user interface to use Sage. So once we have a Sage notebook server up and running, all we want is a browser to access the Sage functionality. For example there is an official instance of Sage Notebook server running at http://sagenb.org You can visit that page, create an account there and start using Sage! So all you need is just -a browser, a modern browser - -{{{ Intentional *cough* *cough* }}} - -#[[Bhanu: what? Are you serious?]] - -to use Sage and nothing else! The Sage notebook also provides a -convenient way of sharing and publishing our work, which is very handy -for research and teaching. +a modern browser to use Sage and nothing else! The Sage notebook also +provides a convenient way of sharing and publishing our work, which +is very handy for research and teaching. However we can also run our own instances of Sage notebook servers on -all the computers we have a local installation of Sage. To start the -notebook server just type:: +all the computers, if we have a local installation of Sage. To start the +notebook server just type +:: - notebook() + notebook() -on the Sage prompt. This will start the Sage Notebook server. If we -are starting the notebook server for the first time, we are prompted -to enter the password for the admin. Type the password and make a note -of it. After this Sage automatically starts a browser page for you +This will start the Sage Notebook server. If we are starting the notebook +server for the first time, we are prompted to enter the password for +the admin. Type the password and make a note of it. +After this Sage automatically starts a browser page for you with the notebook opened. -If it doesn't automatically start a browser page check if the Notebook -server started and there were no problems. If so open your browser and -in the address bar type the URL shown in the instructions upon running +If it doesn't automatically start a browser page, check if the Notebook +server started and there were no problems. If so, open your browser and +in the address bar, type the URL shown in the instructions upon running the notebook command on the sage prompt. -{{{ The notebook() command gives an instruction telling -Open your web browser to http://localhost:8000. Point towards it }}} +The notebook() command gives an instruction telling +Open your web browser to http://localhost:8000. + +{{{ Point towards it }}} In our case it is http://localhost:{{{ Tell whatever is shown }}} {{{ Show the browser with Sage notebook }}} +{{{ If you are logged in tell that you are logged in, log out and show +what is said above for the login page }}} + If you are not logged in yet, it shows the Notebook home page and textboxes to type the username and the password. You can use the username 'admin' and the password you gave while starting the notebook server for the first time. There are also links to recover forgotten password and to create new accounts. -{{{ If you are logged in tell that you are logged in, log out and show -what is said above for the login page }}} - Once we are logged in with the admin account we can see the notebook admin page. A notebook can contain a collection of Sage Notebook worksheets. Worksheet is basically a working area. This is where we enter all the Sage commands on the notebook. +{{{ Point at the links on the top of the page }}} + The admin page lists all the worksheets created. On the topmost part of this page we have the links to various pages. -{{{ Whenever you talk on an individual link point your mouse towards -the link. For each of the link go to the page and explain as below }}} +{{{ Point at the links as they are described }}} The home link takes us to the admin home page. The published link takes us to the page which lists all the published worksheets. The log @@ -148,39 +156,40 @@ We can create a new worksheet by clicking New Worksheet link {{{ Click on the link }}} Sage prompts you for a name for the worksheet. Let us name the -worksheet as nbtutorial. Now we have our first worksheet which is +worksheet as 'nbtutorial'. Now we have our first worksheet which is empty. A worksheet will contain a collection of cells. Every Sage command -must be entered in this cell. Cell is equivalent to the prompt on +must be entered in this cell.A cell is equivalent to the prompt on console. When we create a new worksheet, to start with we will have -one empty cell. Let us try out some math here:: +one empty cell. Let us try out some math here +:: - 2 + 2 - 57.1 ^ 100 + 2 + 2 + 57.1 ^ 100 -The cap operator is used for exponentiation. If you observed carefully +The cap operator is used for exponentiation. If you observed carefully, we typed two commands but the output of only last command was displayed. By default each cell displays the result of only the last operation. We have to use print statement to display all the results we want to be displayed. -{{{ Demonstrate creating a new cell }}} - -Now to perform more operations we want more cells. So how do we create +Now to perform more operations, we want more cells. So how do we create a new cell? It is very simple. As we hover our mouse above or below the existing cells we see a blue line, by clicking on this new line we can create a new cell. +{{{ Click on the link }}} + We have a cell, we have typed some commands in it, but how do we evaluate that cell? Pressing Shift along with Enter evaluates the cell. Alternatively we can also click on the evaluate link to evaluate the cell -{{{ Evaluate the cell and demonstrate for both methods separately -}}}:: +{{{ Evaluate the cell and demonstrate for both methods separately }}} +:: - matrix([[1,2], [3,4]])^(-1) + matrix([[1,2], [3,4]])^(-1) After we create many cells, we may want to move between the cells. To move between the cells use Up and Down arrow keys. Also clicking on @@ -190,73 +199,79 @@ the cell will let you edit that particular cell. To delete a cell, clear the contents of the cell and hit backspace -{{{ Clear and demonstrate deleting the cell }}}:: - - Makes no sense +{{{ Clear and demonstrate deleting the cell }}} -If you want to add annotations in the worksheet itself on the blue +If you want to add annotations in the worksheet itself, on the blue line that appears on hovering the mouse around the cell, Hold Shift and click on the line. This creates a What You See Is What You Get cell. {{{ Create a HTML editable cell }}} -We can make our text here rich text. We can make it bold, Italics, we -can create bulleted and enumerated lists in this area:: +We can make our text here. We can make it bold, Italics, we +can create bulleted and enumerated lists in this area +:: - This text contains both the **bold** text and also *italicised* - text. - It also contains bulleted list: - * Item 1 - * Item 2 - It also contains enumerate list: - 1. Item 1 - 2. Item 2 + This text contains both the **bold** text and also *italicised* + text. + It also contains bulleted list: + * Item 1 + * Item 2 + It also contains enumerate list: + 1. Item 1 + 2. Item 2 In the same cell we can display typeset math using the LaTeX like -syntax:: +syntax +:: - $\int_0^\infty e^{-x} \, dx$ + $\int_0^\infty e^{-x} \, dx$ We enclose the math to be typeset within $ and $ or $$ and $$ as in LaTeX. We can also obtain help for a particular Sage command or function within the worksheet itself by using a question mark following the -command:: +command +:: - sin? + sin? -Evaluating this cell gives me the entire help for the sin function +Evaluating this cell gives me the entire help for the sine function inline on the worksheet itself. Similarly we can also look at the -source code of each command or function using double question mark:: +source code of each command or function using double question mark +:: - matrix?? + matrix?? Sage notebook also provides the feature for autocompletion. To autocomplete a command type first few unique characters and hit tab -key:: +key +:: - sudo<tab> + sudo<tab> To see all the commands starting with a specific name type those -characters and hit tab:: +characters and hit tab +:: - plo<tab> + plo<tab> To list all the methods that are available for a certain variable or -a datatype we can use the variable name followed by the dot to access -the methods available on it and then hit tab:: +a datatype, we can use the variable name followed by the dot to access +the methods available on it and then hit tab +:: - s = 'Hello' - s.rep<tab> + s = 'Hello' + s.rep<tab> The output produced by each cell can be one of the three states. It can be either the full output, or truncated output or hidden output. -The output area will display the error if the Sage code we wrote in -the cell did not successfully execute:: +The output area will display the error, if the Sage code we wrote in +the cell did not successfully execute +:: - a, b = 10 + a, b = 10 {{{ Show the three states }}} @@ -270,56 +285,80 @@ worksheet can contain code written in a specific language. It is possible to instruct Sage to interpret the code in the language we have written. This can be done by putting percentage sign(%) followed by the name of the language. For example, to interpret the cell as -Python code we put:: +Python code we put as the first line in the cell. +:: - %python + %python -as the first line in the cell. Similarly we have: %sh for shell -scripting, %fortran for Fortran, %gap for GAP and so on. Let us see +Similarly we have: %sh for shell scripting, + %fortran for Fortran, %gap for GAP and so on. Let us see how this works. Say I have an integer. The type of the integer in default Sage mode is -{{{ Read the output }}}:: - a = 1 - type(a) +:: - Output: <type 'sage.rings.integer.Integer'> + a = 1 + type(a) + +{{{ Read the output }}} + +Output: <type 'sage.rings.integer.Integer'> We see that Integers are Sage Integers. Now let us put %python as the -first line of the cell and execute the same code snippet:: +first line of the cell and execute the same code snippet +:: - %python - a = 1 - type(a) + %python + a = 1 + type(a) - Output: <type 'int'> +{{{ Read the output }}} + +Output: <type 'int'> Now we see that the integer is a Python integer. Why? Because now we instructed Sage to interpret that cell as Python code. -This brings us to the end of the tutorial on using Sage. We learnt -quite a lot about using the Notebook User Interface of Sage. We are -now confident that we can comfortably use the notebook to learn more -about Sage in the following tutorials. Let us summarize what we -learnt. In this session we learnt - - * What is Sage - * How to start Sage shell - * What is Sage notebook - * How to start the Sage notebook - * How to create accounts and start using the notebook - * How to create new worksheets - * The menus available on the notebook - * About cells in the worksheet - * Methods to evaluate the cell, create new cells, delete the cells - and navigate around the cells - * To make annotations in the worksheet - * Tab completions - * And embedding code of other scripting languages in the cells - -{{{ 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. +This brings us to the end of this tutorial.In thus tutorial, +we have learnt to, + + 1. Know about Sage and sage notebook. + #. Start Sage shell and sage notebook. + #. Create accounts and start using the notebook. + #. Create new worksheets. + #. Access the menus available on the notebook. + #. Evaluate cells in the worksheet. + #. Create new cells, delete the cells. + and navigate around the cells. + #. Make annotations in the worksheet. + #. Use tab completions. + #. Embed code of other scripting languages in the cells. + +{{{Show self assessment questions slide}}} + +Here are some self assessment questions for you to solve + +1. Each cell in a sage worksheet displays the result of only the last + operation. + True or False. + +2. How do you evaluate a cell using the keyboard keys? + + - Shift key along with enter key + - Control key along with enter key + - Alt key along with enter key + + +{{{solution of self assessment questions on slide}}} + +And the answers, + +1. True.By default each cell displays the result of only the last + operation. + +2. Pressing Shift along with Enter evaluates the cell. + +{{{ Show the Thankyou slide }}} + +Hope you have enjoyed This tutorial and found it useful. Thank you! diff --git a/getting_started_with_sage_notebook/slides.org b/getting_started_with_sage_notebook/slides.org index 3d29d87..2b77ced 100644 --- a/getting_started_with_sage_notebook/slides.org +++ b/getting_started_with_sage_notebook/slides.org @@ -18,7 +18,7 @@ #+LaTeX_HEADER: commentstyle=\color{red}\itshape, stringstyle=\color{darkgreen}, #+LaTeX_HEADER: showstringspaces=false, keywordstyle=\color{blue}\bfseries} -#+TITLE: Getting started -- Sage +#+TITLE: #+AUTHOR: FOSSEE #+EMAIL: #+DATE: @@ -29,17 +29,35 @@ #+OPTIONS: H:3 num:nil toc:nil \n:nil @:t ::t |:t ^:t -:t f:t *:t <:t #+OPTIONS: TeX:t LaTeX:nil skip:nil d:nil todo:nil pri:nil tags:not-in-toc -* Outline - - Know what Sage and Sage notebook are. - - Be able to start a Sage shell or notebook - - Be able to start using the notebook - - Be able to create new worksheets - - Know about the menu options available - - Know about the cells in the worksheet - - Be able to evaluate cells, create and delete cells, navigate them. - - Be able to make annotations in the worksheet - - Be able to use tab completion. - - Be able to use code from other languages in the cells. +* +#+begin_latex +\begin{center} +\vspace{12pt} +\textcolor{blue}{\huge Getting started with Sage} +\end{center} +\vspace{18pt} +\begin{center} +\vspace{10pt} +\includegraphics[scale=0.95]{../images/fossee-logo.png}\\ +\vspace{5pt} +\scriptsize Developed by FOSSEE Team, IIT-Bombay. \\ +\scriptsize Funded by National Mission on Education through ICT\\ +\scriptsize MHRD,Govt. of India\\ +\includegraphics[scale=0.30]{../images/iitb-logo.png}\\ +\end{center} +#+end_latex +* Objectives + At the end of this tutorial, you will be able to, + + - Know what Sage and Sage notebook are. + - Start a Sage shell or notebook. + - Create new worksheets. + - Know about the menu options available and the cells in the worksheet. + - Evaluate cells, create and delete cells, navigate them. + - Make annotations in the worksheet. + - Use tab completion. + - Use code from other languages in the cells. + - Use the offline help available. * What is Sage? - free, open-source mathematical software. - can do a lot of math for you, including, but not limited to @@ -48,31 +66,50 @@ + cryptography + graph theory - can be used as aid in teaching and research +* Installing Sage + Visit the page + http://sagemath.org/doc/tutorial/introduction.html + for the tutorial on how to install Sage. + * Summary - + What is Sage - + How to start Sage shell - + What is Sage notebook - + How to start the Sage notebook - + How to create accounts and start using the notebook - + How to create new worksheets - + The menus available on the notebook - + About cells in the worksheet - + Methods to evaluate the cell, create new cells, delete the cells - and navigate around the cells - + To make annotations in the worksheet - + Tab completions - + And embedding code of other scripting languages in the cells -* Thank you! + In thus tutorial, we have learnt to, + + - Know about Sage and sage notebook. + - Start Sage shell and sage notebook. + - Create accounts and start using the notebook. + - Create new worksheets. + - Access the menus available on the notebook. + - Evaluate cells in the worksheet. + - Create new cells, delete the cells. + and navigate around the cells. + - Make annotations in the worksheet. + - Use tab completions. + - Embed code of other scripting languages in the cells. +* Evaluation + 1. Each cell in a sage worksheet displays the result of only the last + operation. + True or False. + + 2. How do you evaluate a cell using the keyboard keys? + + - Shift key along with enter key + - Control key along with enter key + - Alt key along with enter key +* Solutions + 1. True + + 2. Shift key along with enter key +* #+begin_latex \begin{block}{} \begin{center} - This spoken tutorial has been produced by the - \textcolor{blue}{FOSSEE} team, which is funded by the + \textcolor{blue}{\Large THANK YOU!} \end{center} + \end{block} +\begin{block}{} \begin{center} - \textcolor{blue}{National Mission on Education through \\ - Information \& Communication Technology \\ - MHRD, Govt. of India}. + For more Information, visit our website\\ + \url{http://fossee.in/} \end{center} \end{block} #+end_latex diff --git a/getting_started_with_sage_notebook/slides.tex b/getting_started_with_sage_notebook/slides.tex index a641fcd..c6c5d6b 100644 --- a/getting_started_with_sage_notebook/slides.tex +++ b/getting_started_with_sage_notebook/slides.tex @@ -1,4 +1,4 @@ -% Created 2010-11-11 Thu 02:40 +% Created 2011-06-13 Mon 14:38 \documentclass[presentation]{beamer} \usepackage[latin1]{inputenc} \usepackage[T1]{fontenc} @@ -23,14 +23,13 @@ commentstyle=\color{red}\itshape, stringstyle=\color{darkgreen}, showstringspaces=false, keywordstyle=\color{blue}\bfseries} \providecommand{\alert}[1]{\textbf{#1}} -\title{Getting started -- Sage} +\title{} \author{FOSSEE} \date{} \usetheme{Warsaw}\usecolortheme{default}\useoutertheme{infolines}\setbeamercovered{transparent} \begin{document} -\maketitle @@ -40,76 +39,135 @@ showstringspaces=false, keywordstyle=\color{blue}\bfseries} + +\begin{frame} + +\begin{center} +\vspace{12pt} +\textcolor{blue}{\huge Getting started with Sage} +\end{center} +\vspace{18pt} +\begin{center} +\vspace{10pt} +\includegraphics[scale=0.95]{../images/fossee-logo.png}\\ +\vspace{5pt} +\scriptsize Developed by FOSSEE Team, IIT-Bombay. \\ +\scriptsize Funded by National Mission on Education through ICT\\ +\scriptsize MHRD,Govt. of India\\ +\includegraphics[scale=0.30]{../images/iitb-logo.png}\\ +\end{center} +\end{frame} \begin{frame} -\frametitle{Outline} -\label{sec-1} +\frametitle{Objectives} +\label{sec-2} + + At the end of this tutorial, you will be able to, + \begin{itemize} \item Know what Sage and Sage notebook are. -\item Be able to start a Sage shell or notebook -\item Be able to start using the notebook -\item Be able to create new worksheets -\item Know about the menu options available -\item Know about the cells in the worksheet -\item Be able to evaluate cells, create and delete cells, navigate them. -\item Be able to make annotations in the worksheet -\item Be able to use tab completion. -\item Be able to use code from other languages in the cells. +\item Start a Sage shell or notebook. +\item Create new worksheets. +\item Know about the menu options available and the cells in the worksheet. +\item Evaluate cells, create and delete cells, navigate them. +\item Make annotations in the worksheet. +\item Use tab completion. +\item Use code from other languages in the cells. +\item Use the offline help available. \end{itemize} \end{frame} \begin{frame} \frametitle{What is Sage?} -\label{sec-2} +\label{sec-3} + \begin{itemize} \item free, open-source mathematical software. \item can do a lot of math for you, including, but not limited to - \begin{itemize} \item algebra \item geometry \item cryptography \item graph theory \end{itemize} - \item can be used as aid in teaching and research \end{itemize} \end{frame} \begin{frame} +\frametitle{Installing Sage} +\label{sec-4} + + Visit the page\\ +\vspace{8pt} + \url{http://sagemath.org/doc/tutorial/introduction.html}\\ +\vspace{5pt} + \url{http://sagemath.org/doc/tutorial/introduction.html}\\ +\vspace{8pt} + for the tutorial on how to install Sage. +\end{frame} +\begin{frame} \frametitle{Summary} -\label{sec-3} +\label{sec-5} + + In thus tutorial, we have learnt to, + \begin{itemize} -\item What is Sage -\item How to start Sage shell -\item What is Sage notebook -\item How to start the Sage notebook -\item How to create accounts and start using the notebook -\item How to create new worksheets -\item The menus available on the notebook -\item About cells in the worksheet -\item Methods to evaluate the cell, create new cells, delete the cells - and navigate around the cells -\item To make annotations in the worksheet -\item Tab completions -\item And embedding code of other scripting languages in the cells +\item Know about Sage and sage notebook. +\item Start Sage shell and sage notebook. +\item Create accounts and start using the notebook. +\item Create new worksheets. +\item Access the menus available on the notebook. +\item Evaluate cells in the worksheet. +\item Create new cells, delete the cells. + and navigate around the cells. +\item Make annotations in the worksheet. +\item Use tab completions. +\item Embed code of other scripting languages in the cells. \end{itemize} \end{frame} \begin{frame} -\frametitle{Thank you!} -\label{sec-4} +\frametitle{Evaluation} +\label{sec-6} + + +\begin{enumerate} +\item Each cell in a sage worksheet displays the result of only the last + operation.\\ + True or False. +\vspace{12pt} +\item How do you evaluate a cell using the keyboard keys? +\begin{itemize} +\item Shift key along with enter key +\item Control key along with enter key +\item Alt key along with enter key +\end{itemize} +\end{enumerate} +\end{frame} +\begin{frame} +\frametitle{Solutions} +\label{sec-7} + + +\begin{enumerate} +\item True +\vspace{12pt} +\item Shift key along with enter key +\end{enumerate} +\end{frame} +\begin{frame} \begin{block}{} \begin{center} - This spoken tutorial has been produced by the - \textcolor{blue}{FOSSEE} team, which is funded by the + \textcolor{blue}{\Large THANK YOU!} \end{center} + \end{block} +\begin{block}{} \begin{center} - \textcolor{blue}{National Mission on Education through \\ - Information \& Communication Technology \\ - MHRD, Govt. of India}. + For more Information, visit our website\\ + \url{http://fossee.in/} \end{center} \end{block} \end{frame} -\end{document} +\end{document}
\ No newline at end of file |