diff options
author | Puneeth Chaganti | 2010-12-01 16:51:35 +0530 |
---|---|---|
committer | Puneeth Chaganti | 2010-12-01 16:51:35 +0530 |
commit | f3a34dfb4e879f3eb7274704f44546aac4add88f (patch) | |
tree | 1cb0a8cc5dbd5ee2b374350915ed2addfa0fb447 /getting-started-ipython | |
parent | 347866ed0d29db61ee062563b1e1616cfb85588c (diff) | |
download | st-scripts-f3a34dfb4e879f3eb7274704f44546aac4add88f.tar.gz st-scripts-f3a34dfb4e879f3eb7274704f44546aac4add88f.tar.bz2 st-scripts-f3a34dfb4e879f3eb7274704f44546aac4add88f.zip |
Renamed all LOs to match with their names in progress.org.
Diffstat (limited to 'getting-started-ipython')
-rw-r--r-- | getting-started-ipython/quickref.tex | 14 | ||||
-rw-r--r-- | getting-started-ipython/script.rst | 235 | ||||
-rw-r--r-- | getting-started-ipython/slides.org | 99 | ||||
-rw-r--r-- | getting-started-ipython/slides.tex | 154 |
4 files changed, 0 insertions, 502 deletions
diff --git a/getting-started-ipython/quickref.tex b/getting-started-ipython/quickref.tex deleted file mode 100644 index 460b921..0000000 --- a/getting-started-ipython/quickref.tex +++ /dev/null @@ -1,14 +0,0 @@ -\textbf{Getting started -- \texttt{ipython}} - -To start \lstinline|ipython| with \lstinline|pylab|:\\ -\lstinline| $ ipython -pylab| %$ - -To exit: \lstinline|^D| (Ctrl-D) - -To interrupt: \lstinline|^C| (Ctrl-C) - -Tab completes partial commands - -\texttt{?} to look up documentation. - -Arrow keys to navigate the history. diff --git a/getting-started-ipython/script.rst b/getting-started-ipython/script.rst deleted file mode 100644 index 703cccc..0000000 --- a/getting-started-ipython/script.rst +++ /dev/null @@ -1,235 +0,0 @@ -.. Objectives -.. ---------- - -.. At the end of this tutorial, you will be able to - -.. 1. invoke the ``ipython`` interpreter. -.. #. quit the ``ipython`` interpreter. -.. #. navigate in the history of ``ipython``. -.. #. use tab-completion. -.. #. look-up documentation of functions. -.. #. interrupt incomplete or incorrect commands. - -.. Prerequisites -.. ------------- - -.. should have ``ipython`` and ``pylab`` installed. - -.. Author : Puneeth - Internal Reviewer : Anoop Jacob Thomas<anoop@fossee.in> - Language Review : Bhanukiran - External Reviewer : - Checklist OK? : <put date stamp here, if OK> [2010-10-05] - - -Script ------- - -{{{ Show the slide containing title }}} - -Hello Friends and Welcome to the tutorial on getting started with -``ipython``. - -{{{ Show slide with outline }}} - -This tutorial will cover the basic usage of the ``ipython`` -interpreter. The following topics would be covered. - -IPython is an enhanced Python interpreter that provides features like -tabcompletion, easier access to help and lot of other functionality -which are not available in the vanilla Python interpreter. - -First let us see how to invoke the ``ipython`` interpreter. - -We type -:: - - ipython - -at the terminal prompt to invoke the ipython interpreter. - -We get a prompt with ``In [1]:`` after getting some information about -the version of Python installed and some help commands. - -If you get an error saying something like ``ipython is not -installed``, refer to the tutorial on how to install the packages -required for this course. - -Now, to quit the ipython interpreter, type Ctrl-D. You are prompted -asking if you really want to exit, type y to say yes and quit ipython. - -Start ipython again, as you did before. - -The prompt that you have says ``In [1]``. ``In`` stands for input and the -ipython interpreter is ready to accept input from you. - -Now let us see, how we can type some commands into the interpreter. - -Start with the simplest thing, addition. - -Let's type -:: - 1+2 - -at the prompt. IPython promptly gives back the output as 3. Notice -that the output is displayed with an ``Out[1]`` indication. - -.. #[[Anoop: I think we can illustrate In [] and Out[] in slides]] -.. #[[Puneeth: I think we can do that on the terminal?]] - -Let's try out few other mathematical operations. -:: - - 5 - 3 - 7 - 4 - 6 * 5 - -Now let's ``print 1+2``. Instead of typing the whole thing, we make -use of the fact that IPython remembers the history of the commands -that you have already used. We use the up arrow key to go back the -command ``1+2``. We then use the left-arrow key to navigate to the -beginning of the line and add the word ``print`` and a space. Then hit -enter and observe that the interpreter prints out the value as 3, -without the Out[] indication. - -Now, let's change the previous command ``print 1+2`` to ``print -10*2``. We use the up arrow again to navigate to the previous command -and use the left arrow key to move the cursor on to the + symbol and -then use the delete key to remove it and type 0 and * to change the -expression as required. We hit enter to see the output of -``print``. - -Now, let's say we want to use the function ``round``. We type ``ro`` -at the prompt and hit the tab key. As you can see, IPython -completes the command. This feature is called the tab-completion. - -Now, we remove all the characters and just type ``r`` and then hit -tab. IPython does not complete the command since there are many -possibilities. It just lists out all the possible completions. - -Following is an exercise that you must do. - -%%1%% Type ``ab`` and hit tab to see what happens. Next, just type -``a`` and hit tab to see what happens. - -Please, pause the video here. Do the exercise and then continue. - -``ab`` tab completes to ``abs`` and ``a<tab>`` gives us a list of all -the commands starting with a. - -Now, let's see what these functions are used for. We will use the -help features of ipython to find this out. - -.. #[[Anoop: Another slide which says about ? mark and round? etc, as - few people cannot just follow by listening (like me) :)]] - -.. #[Punch: These things are shown on the terminal. I feel we don't -.. need slide, here I guess.] - -To get the help of any function, we first type the function, ``abs`` -in our case and then add a ? at the end and hit enter. - -As the documentation says, ``abs`` accepts a number as an input and -returns it's absolute value. - -We say, -:: - - abs(-19) - - abs(19) - -We get 19, as expected, in both the cases. - -Does it work for decimals (or floats)? Let's try typing abs(-10.5) -and we do get back 10.5. - -Following is an exercise that you must do. - -%%2%% Look-up the documentation of ``round`` and see how to use it. - -Please, pause the video here. Do the exercise and then continue. - -:: - - round? - -If you notice, there are extra square brackets around the ``ndigits``. -This means that ``ndigits`` is optional and 0 is the default value. -Optional parameters are shown in square brackets anywhere in Python -documentation. - -The function ``round``, rounds a number to a given precision. - -Following are exercises that you must do. - -%%3%% Check the output of:: - - round(2.48) - round(2.48, 1) - round(2.48, 2) - - round(2.484) - round(2.484, 1) - round(2.484, 2) - -Please, pause the video here. Do the exercises and then continue. - -We get 2.0, 2.5 and 2.48, which are what we expect. - -Let's now see how to correct typing errors that we make while typing at -the terminal. As already shown, if we haven't hit the enter key -already, we could navigate using the arrow keys and make deletions -using delete or backspace key and correct the errors. - -Let's now type round(2.484 and hit enter, without closing the -parenthesis. We get a prompt with dots. This prompt is the -continuation prompt of ``ipython``. It appears, the previous line is -incomplete in some way. We now complete the command by typing, the -closing parenthesis and hitting enter. We get the expected output of -2.5. - -In other instances, if we commit a typing error with a longer and more -complex expression and end up with the continuation prompt, we can -type Ctrl-C to interrupt the command and get back the ``ipython`` input -prompt. - -Following is an exercise that you must do. - -%%4%% Try typing round(2.484, and hit enter. and then cancel the -command using Ctrl-C. Then, type the command, round(2.484, 2) and -resume the video. - -Please, pause the video here. Do the exercises and then continue. - -:: - - round(2.484 - ^C - - round(2.484, 2) - -This brings us to the end of the tutorial on getting started with -``ipython``. - -.. #[[Anoop: add slides for interrupts, navigating history, I feel - even a single point will also do]] - -.. #[Puneeth: I don't feel these things cannot be shown on a slide.] - -In this tutorial we have learnt, how to -{{{ show the outline/summary slide. }}} - - 1. invoke the ``ipython`` interpreter. - #. quit the ``ipython`` interpreter. - #. navigate in the history of ``ipython``. - #. use tab-completion. - #. look-up documentation of functions. - #. interrupt incomplete or incorrect commands. - -{{{ 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! diff --git a/getting-started-ipython/slides.org b/getting-started-ipython/slides.org deleted file mode 100644 index d729cca..0000000 --- a/getting-started-ipython/slides.org +++ /dev/null @@ -1,99 +0,0 @@ -#+LaTeX_CLASS: beamer -#+LaTeX_CLASS_OPTIONS: [presentation] -#+BEAMER_FRAME_LEVEL: 1 - -#+BEAMER_HEADER_EXTRA: \usetheme{Warsaw}\usecolortheme{default}\useoutertheme{infolines}\setbeamercovered{transparent} -#+COLUMNS: %45ITEM %10BEAMER_env(Env) %10BEAMER_envargs(Env Args) %4BEAMER_col(Col) %8BEAMER_extra(Extra) -#+PROPERTY: BEAMER_col_ALL 0.1 0.2 0.3 0.4 0.5 0.6 0.7 0.8 0.9 1.0 :ETC - -#+LaTeX_CLASS: beamer -#+LaTeX_CLASS_OPTIONS: [presentation] - -#+LaTeX_HEADER: \usepackage[english]{babel} \usepackage{ae,aecompl} -#+LaTeX_HEADER: \usepackage{mathpazo,courier,euler} \usepackage[scaled=.95]{helvet} - -#+LaTeX_HEADER:\usepackage{listings} - -#+LaTeX_HEADER:\lstset{language=Python, basicstyle=\ttfamily\bfseries, -#+LaTeX_HEADER: commentstyle=\color{red}\itshape, stringstyle=\color{darkgreen}, -#+LaTeX_HEADER: showstringspaces=false, keywordstyle=\color{blue}\bfseries} - -#+TITLE: Getting Started -- ~ipython~ -#+AUTHOR: FOSSEE -#+EMAIL: -#+DATE: - -#+DESCRIPTION: -#+KEYWORDS: -#+LANGUAGE: en -#+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 - + invoke the ~ipython~ interpreter - + quit the ~ipython~ interpreter - + navigate in the history of ~ipython~ - + use tab-completion - + look-up documentation of functions - + interrupt incomplete or incorrect commands -* Question 1 - Type =ab= and hit tab to see what happens. Next, just type =a= and - hit tab to see what happens. -* Solution 1 - =ab= tab completes to =abs= and =a<tab>= gives us a list of all the - commands starting with a. -* Question 2 - Look-up the documentation of =round= and see how to use it. -* Solution 2 - =round?= -* Question 3 - Check the output of - #+begin_src python - round(2.48) - round(2.48, 1) - round(2.48, 2) - - round(2.484) - round(2.484, 1) - round(2.484, 2) - #+end_src - Look-up the documentation of =round= and see how to use it. -* Solution 3 - We get 2.0, 2.5 and 2.48, which are what we expect. -* Question 4 - Try typing =round(2.484=, and hit enter. and then cancel the command - using Ctrl-C. Then, type the command, =round(2.484, 2)= and resume - the video. -* Solution 4 - #+begin_src python - round(2.484 - ^C - - round(2.484, 2) - #+end_src - - - -* Summary - + invoking and quitting the ~ipython~ interpreter - + navigating the history - + using tab-completion to work faster - + looking-up documentation using ~?~ - + sending keyboard interrupts using ~Ctrl-C~ - -* Thank you! -#+begin_latex - \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_latex - - diff --git a/getting-started-ipython/slides.tex b/getting-started-ipython/slides.tex deleted file mode 100644 index 310db35..0000000 --- a/getting-started-ipython/slides.tex +++ /dev/null @@ -1,154 +0,0 @@ -% Created 2010-11-05 Fri 20:59 -\documentclass[presentation]{beamer} -\usepackage[latin1]{inputenc} -\usepackage[T1]{fontenc} -\usepackage{fixltx2e} -\usepackage{graphicx} -\usepackage{longtable} -\usepackage{float} -\usepackage{wrapfig} -\usepackage{soul} -\usepackage{textcomp} -\usepackage{marvosym} -\usepackage{wasysym} -\usepackage{latexsym} -\usepackage{amssymb} -\usepackage{hyperref} -\tolerance=1000 -\usepackage[english]{babel} \usepackage{ae,aecompl} -\usepackage{mathpazo,courier,euler} \usepackage[scaled=.95]{helvet} -\usepackage{listings} -\lstset{language=Python, basicstyle=\ttfamily\bfseries, -commentstyle=\color{red}\itshape, stringstyle=\color{darkgreen}, -showstringspaces=false, keywordstyle=\color{blue}\bfseries} -\providecommand{\alert}[1]{\textbf{#1}} - -\title{Getting Started -- \texttt{ipython}} -\author{FOSSEE} -\date{} - -\usetheme{Warsaw}\usecolortheme{default}\useoutertheme{infolines}\setbeamercovered{transparent} -\begin{document} - -\maketitle - - - - - - - - - -\begin{frame} -\frametitle{Outline} -\label{sec-1} - -\begin{itemize} -\item invoke the \texttt{ipython} interpreter -\item quit the \texttt{ipython} interpreter -\item navigate in the history of \texttt{ipython} -\item use tab-completion -\item look-up documentation of functions -\item interrupt incomplete or incorrect commands -\end{itemize} -\end{frame} -\begin{frame} -\frametitle{Question 1} -\label{sec-2} - - Type \texttt{ab} and hit tab to see what happens. Next, just type \texttt{a} and - hit tab to see what happens. -\end{frame} -\begin{frame} -\frametitle{Solution 1} -\label{sec-3} - - \texttt{ab} tab completes to \texttt{abs} and \texttt{a<tab>} gives us a list of all the - commands starting with a. -\end{frame} -\begin{frame} -\frametitle{Question 2} -\label{sec-4} - - Look-up the documentation of \texttt{round} and see how to use it. -\end{frame} -\begin{frame} -\frametitle{Solution 2} -\label{sec-5} - - \texttt{round?} -\end{frame} -\begin{frame}[fragile] -\frametitle{Question 3} -\label{sec-6} - - Check the output of -\lstset{language=Python} -\begin{lstlisting} -round(2.48) -round(2.48, 1) -round(2.48, 2) - -round(2.484) -round(2.484, 1) -round(2.484, 2) -\end{lstlisting} - Look-up the documentation of \texttt{round} and see how to use it. -\end{frame} -\begin{frame} -\frametitle{Solution 3} -\label{sec-7} - - We get 2.0, 2.5 and 2.48, which are what we expect. -\end{frame} -\begin{frame} -\frametitle{Question 4} -\label{sec-8} - - Try typing \texttt{round(2.484}, and hit enter. and then cancel the command - using Ctrl-C. Then, type the command, \texttt{round(2.484, 2)} and resume - the video. -\end{frame} -\begin{frame}[fragile] -\frametitle{Solution 4} -\label{sec-9} - -\lstset{language=Python} -\begin{lstlisting} -round(2.484 -^C - -round(2.484, 2) -\end{lstlisting} -\end{frame} -\begin{frame} -\frametitle{Summary} -\label{sec-10} - -\begin{itemize} -\item invoking and quitting the \texttt{ipython} interpreter -\item navigating the history -\item using tab-completion to work faster -\item looking-up documentation using \texttt{?} -\item sending keyboard interrupts using \texttt{Ctrl-C} -\end{itemize} -\end{frame} -\begin{frame} -\frametitle{Thank you!} -\label{sec-11} - - \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} |