getting-started-sagenotebook.rst
author Madhusudan.C.S <madhusudancs@gmail.com>
Fri, 17 Sep 2010 23:29:48 +0530
changeset 168 13280334ca2b
child 169 0b0620ae8f4d
permissions -rw-r--r--
Adding some sections on getting started with Sage notebook.
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
168
13280334ca2b Adding some sections on getting started with Sage notebook.
Madhusudan.C.S <madhusudancs@gmail.com>
parents:
diff changeset
     1
Hello friends. Welcome to this spoken tutorial on Getting started with
13280334ca2b Adding some sections on getting started with Sage notebook.
Madhusudan.C.S <madhusudancs@gmail.com>
parents:
diff changeset
     2
sage and sage notebook.
13280334ca2b Adding some sections on getting started with Sage notebook.
Madhusudan.C.S <madhusudancs@gmail.com>
parents:
diff changeset
     3
13280334ca2b Adding some sections on getting started with Sage notebook.
Madhusudan.C.S <madhusudancs@gmail.com>
parents:
diff changeset
     4
{{{ Show the slide containing the title }}}
13280334ca2b Adding some sections on getting started with Sage notebook.
Madhusudan.C.S <madhusudancs@gmail.com>
parents:
diff changeset
     5
13280334ca2b Adding some sections on getting started with Sage notebook.
Madhusudan.C.S <madhusudancs@gmail.com>
parents:
diff changeset
     6
{{{ Show the slide containing the outline }}}
13280334ca2b Adding some sections on getting started with Sage notebook.
Madhusudan.C.S <madhusudancs@gmail.com>
parents:
diff changeset
     7
13280334ca2b Adding some sections on getting started with Sage notebook.
Madhusudan.C.S <madhusudancs@gmail.com>
parents:
diff changeset
     8
In this tutorial, we will learn what Sage is, what is Sage notebook,
13280334ca2b Adding some sections on getting started with Sage notebook.
Madhusudan.C.S <madhusudancs@gmail.com>
parents:
diff changeset
     9
how to start and use the sage notebook. In the notebook we will be
13280334ca2b Adding some sections on getting started with Sage notebook.
Madhusudan.C.S <madhusudancs@gmail.com>
parents:
diff changeset
    10
specifically learning how to execute our code, how to write
13280334ca2b Adding some sections on getting started with Sage notebook.
Madhusudan.C.S <madhusudancs@gmail.com>
parents:
diff changeset
    11
annotations and other content, typesetting the content and how to use
13280334ca2b Adding some sections on getting started with Sage notebook.
Madhusudan.C.S <madhusudancs@gmail.com>
parents:
diff changeset
    12
the offline help available.
13280334ca2b Adding some sections on getting started with Sage notebook.
Madhusudan.C.S <madhusudancs@gmail.com>
parents:
diff changeset
    13
13280334ca2b Adding some sections on getting started with Sage notebook.
Madhusudan.C.S <madhusudancs@gmail.com>
parents:
diff changeset
    14
{{{ Show the slide on what is Sage }}}
13280334ca2b Adding some sections on getting started with Sage notebook.
Madhusudan.C.S <madhusudancs@gmail.com>
parents:
diff changeset
    15
13280334ca2b Adding some sections on getting started with Sage notebook.
Madhusudan.C.S <madhusudancs@gmail.com>
parents:
diff changeset
    16
To start with, What is Sage? Sage is a free, open-source mathematical
13280334ca2b Adding some sections on getting started with Sage notebook.
Madhusudan.C.S <madhusudancs@gmail.com>
parents:
diff changeset
    17
software. Sage can do a lot of math stuff for you including but not
13280334ca2b Adding some sections on getting started with Sage notebook.
Madhusudan.C.S <madhusudancs@gmail.com>
parents:
diff changeset
    18
limited to algebra, calculus, geometry, cryptography, graph theory
13280334ca2b Adding some sections on getting started with Sage notebook.
Madhusudan.C.S <madhusudancs@gmail.com>
parents:
diff changeset
    19
among other things. It can also be used as aid in teaching and
13280334ca2b Adding some sections on getting started with Sage notebook.
Madhusudan.C.S <madhusudancs@gmail.com>
parents:
diff changeset
    20
research in any of the areas that Sage supports. So let us start Sage
13280334ca2b Adding some sections on getting started with Sage notebook.
Madhusudan.C.S <madhusudancs@gmail.com>
parents:
diff changeset
    21
now
13280334ca2b Adding some sections on getting started with Sage notebook.
Madhusudan.C.S <madhusudancs@gmail.com>
parents:
diff changeset
    22
13280334ca2b Adding some sections on getting started with Sage notebook.
Madhusudan.C.S <madhusudancs@gmail.com>
parents:
diff changeset
    23
{{{ Shift to terminal }}}
13280334ca2b Adding some sections on getting started with Sage notebook.
Madhusudan.C.S <madhusudancs@gmail.com>
parents:
diff changeset
    24
13280334ca2b Adding some sections on getting started with Sage notebook.
Madhusudan.C.S <madhusudancs@gmail.com>
parents:
diff changeset
    25
We are assuming that you have Sage installed on your computer now. If
13280334ca2b Adding some sections on getting started with Sage notebook.
Madhusudan.C.S <madhusudancs@gmail.com>
parents:
diff changeset
    26
not please visit the page
13280334ca2b Adding some sections on getting started with Sage notebook.
Madhusudan.C.S <madhusudancs@gmail.com>
parents:
diff changeset
    27
http://sagemath.org/doc/tutorial/introduction.html#installation for
13280334ca2b Adding some sections on getting started with Sage notebook.
Madhusudan.C.S <madhusudancs@gmail.com>
parents:
diff changeset
    28
the tutorial on how to install Sage. Let us move on now.
13280334ca2b Adding some sections on getting started with Sage notebook.
Madhusudan.C.S <madhusudancs@gmail.com>
parents:
diff changeset
    29
13280334ca2b Adding some sections on getting started with Sage notebook.
Madhusudan.C.S <madhusudancs@gmail.com>
parents:
diff changeset
    30
On the terminal type::
13280334ca2b Adding some sections on getting started with Sage notebook.
Madhusudan.C.S <madhusudancs@gmail.com>
parents:
diff changeset
    31
13280334ca2b Adding some sections on getting started with Sage notebook.
Madhusudan.C.S <madhusudancs@gmail.com>
parents:
diff changeset
    32
  sage
13280334ca2b Adding some sections on getting started with Sage notebook.
Madhusudan.C.S <madhusudancs@gmail.com>
parents:
diff changeset
    33
13280334ca2b Adding some sections on getting started with Sage notebook.
Madhusudan.C.S <madhusudancs@gmail.com>
parents:
diff changeset
    34
This should start a new Sage shell with the prompt sage: which looks
13280334ca2b Adding some sections on getting started with Sage notebook.
Madhusudan.C.S <madhusudancs@gmail.com>
parents:
diff changeset
    35
like this
13280334ca2b Adding some sections on getting started with Sage notebook.
Madhusudan.C.S <madhusudancs@gmail.com>
parents:
diff changeset
    36
13280334ca2b Adding some sections on getting started with Sage notebook.
Madhusudan.C.S <madhusudancs@gmail.com>
parents:
diff changeset
    37
{{{ Show what is displayed on the terminal }}}
13280334ca2b Adding some sections on getting started with Sage notebook.
Madhusudan.C.S <madhusudancs@gmail.com>
parents:
diff changeset
    38
13280334ca2b Adding some sections on getting started with Sage notebook.
Madhusudan.C.S <madhusudancs@gmail.com>
parents:
diff changeset
    39
So now we can type all the commands that Sage supports here. But Sage
13280334ca2b Adding some sections on getting started with Sage notebook.
Madhusudan.C.S <madhusudancs@gmail.com>
parents:
diff changeset
    40
comes bundled with a much much much more elegant tool called Sage
13280334ca2b Adding some sections on getting started with Sage notebook.
Madhusudan.C.S <madhusudancs@gmail.com>
parents:
diff changeset
    41
Notebook? What is Sage Notebook? Sage Notebook provides a web based
13280334ca2b Adding some sections on getting started with Sage notebook.
Madhusudan.C.S <madhusudancs@gmail.com>
parents:
diff changeset
    42
user interface to use Sage. So once we have a Sage notebook server up
13280334ca2b Adding some sections on getting started with Sage notebook.
Madhusudan.C.S <madhusudancs@gmail.com>
parents:
diff changeset
    43
and running all we want is a browser to access the Sage
13280334ca2b Adding some sections on getting started with Sage notebook.
Madhusudan.C.S <madhusudancs@gmail.com>
parents:
diff changeset
    44
functionality. For example there is an official instance of Sage
13280334ca2b Adding some sections on getting started with Sage notebook.
Madhusudan.C.S <madhusudancs@gmail.com>
parents:
diff changeset
    45
Notebook server running at http://sagenb.org You can visit that page,
13280334ca2b Adding some sections on getting started with Sage notebook.
Madhusudan.C.S <madhusudancs@gmail.com>
parents:
diff changeset
    46
create an account there and start using Sage! So all you need is just
13280334ca2b Adding some sections on getting started with Sage notebook.
Madhusudan.C.S <madhusudancs@gmail.com>
parents:
diff changeset
    47
a browser, a modern browser 
13280334ca2b Adding some sections on getting started with Sage notebook.
Madhusudan.C.S <madhusudancs@gmail.com>
parents:
diff changeset
    48
13280334ca2b Adding some sections on getting started with Sage notebook.
Madhusudan.C.S <madhusudancs@gmail.com>
parents:
diff changeset
    49
{{{ Intentional *cough* *cough* }}}
13280334ca2b Adding some sections on getting started with Sage notebook.
Madhusudan.C.S <madhusudancs@gmail.com>
parents:
diff changeset
    50
13280334ca2b Adding some sections on getting started with Sage notebook.
Madhusudan.C.S <madhusudancs@gmail.com>
parents:
diff changeset
    51
to use Sage and nothing else!
13280334ca2b Adding some sections on getting started with Sage notebook.
Madhusudan.C.S <madhusudancs@gmail.com>
parents:
diff changeset
    52
13280334ca2b Adding some sections on getting started with Sage notebook.
Madhusudan.C.S <madhusudancs@gmail.com>
parents:
diff changeset
    53
However we can also run our own instances of Sage notebook servers on
13280334ca2b Adding some sections on getting started with Sage notebook.
Madhusudan.C.S <madhusudancs@gmail.com>
parents:
diff changeset
    54
all the computers we have a local installation of Sage. To start the
13280334ca2b Adding some sections on getting started with Sage notebook.
Madhusudan.C.S <madhusudancs@gmail.com>
parents:
diff changeset
    55
notebook server just type::
13280334ca2b Adding some sections on getting started with Sage notebook.
Madhusudan.C.S <madhusudancs@gmail.com>
parents:
diff changeset
    56
13280334ca2b Adding some sections on getting started with Sage notebook.
Madhusudan.C.S <madhusudancs@gmail.com>
parents:
diff changeset
    57
  notebook()
13280334ca2b Adding some sections on getting started with Sage notebook.
Madhusudan.C.S <madhusudancs@gmail.com>
parents:
diff changeset
    58
13280334ca2b Adding some sections on getting started with Sage notebook.
Madhusudan.C.S <madhusudancs@gmail.com>
parents:
diff changeset
    59
on the Sage prompt. This will start the Sage Notebook server.
13280334ca2b Adding some sections on getting started with Sage notebook.
Madhusudan.C.S <madhusudancs@gmail.com>
parents:
diff changeset
    60
If we are starting the notebook server for the first time, we are
13280334ca2b Adding some sections on getting started with Sage notebook.
Madhusudan.C.S <madhusudancs@gmail.com>
parents:
diff changeset
    61
prompted to enter the password for the admin. Type the password and
13280334ca2b Adding some sections on getting started with Sage notebook.
Madhusudan.C.S <madhusudancs@gmail.com>
parents:
diff changeset
    62
make a note of it. After this Sage automatically starts a browser page
13280334ca2b Adding some sections on getting started with Sage notebook.
Madhusudan.C.S <madhusudancs@gmail.com>
parents:
diff changeset
    63
for you with the notebook opened.
13280334ca2b Adding some sections on getting started with Sage notebook.
Madhusudan.C.S <madhusudancs@gmail.com>
parents:
diff changeset
    64
13280334ca2b Adding some sections on getting started with Sage notebook.
Madhusudan.C.S <madhusudancs@gmail.com>
parents:
diff changeset
    65
If it doesn't automatically start a browser page check if the Notebook
13280334ca2b Adding some sections on getting started with Sage notebook.
Madhusudan.C.S <madhusudancs@gmail.com>
parents:
diff changeset
    66
server started and there were no problems. If so open your browser and
13280334ca2b Adding some sections on getting started with Sage notebook.
Madhusudan.C.S <madhusudancs@gmail.com>
parents:
diff changeset
    67
in the address bar type the URL shown in the instructions upon running
13280334ca2b Adding some sections on getting started with Sage notebook.
Madhusudan.C.S <madhusudancs@gmail.com>
parents:
diff changeset
    68
the notebook command on the sage prompt.
13280334ca2b Adding some sections on getting started with Sage notebook.
Madhusudan.C.S <madhusudancs@gmail.com>
parents:
diff changeset
    69
13280334ca2b Adding some sections on getting started with Sage notebook.
Madhusudan.C.S <madhusudancs@gmail.com>
parents:
diff changeset
    70
{{{ The notebook() command gives an instruction telling 
13280334ca2b Adding some sections on getting started with Sage notebook.
Madhusudan.C.S <madhusudancs@gmail.com>
parents:
diff changeset
    71
Open your web browser to http://localhost:8000. Point towards it }}}
13280334ca2b Adding some sections on getting started with Sage notebook.
Madhusudan.C.S <madhusudancs@gmail.com>
parents:
diff changeset
    72
13280334ca2b Adding some sections on getting started with Sage notebook.
Madhusudan.C.S <madhusudancs@gmail.com>
parents:
diff changeset
    73
In our case it is http://localhost:{{{ Tell whatever is shown }}}
13280334ca2b Adding some sections on getting started with Sage notebook.
Madhusudan.C.S <madhusudancs@gmail.com>
parents:
diff changeset
    74
13280334ca2b Adding some sections on getting started with Sage notebook.
Madhusudan.C.S <madhusudancs@gmail.com>
parents:
diff changeset
    75
{{{ Show the browser with Sage notebook }}}
13280334ca2b Adding some sections on getting started with Sage notebook.
Madhusudan.C.S <madhusudancs@gmail.com>
parents:
diff changeset
    76
13280334ca2b Adding some sections on getting started with Sage notebook.
Madhusudan.C.S <madhusudancs@gmail.com>
parents:
diff changeset
    77
If you are not logged in yet, it shows the Notebook home page and
13280334ca2b Adding some sections on getting started with Sage notebook.
Madhusudan.C.S <madhusudancs@gmail.com>
parents:
diff changeset
    78
textboxes to type the username and the password. You can use the
13280334ca2b Adding some sections on getting started with Sage notebook.
Madhusudan.C.S <madhusudancs@gmail.com>
parents:
diff changeset
    79
username 'admin' and the password you gave while starting the notebook
13280334ca2b Adding some sections on getting started with Sage notebook.
Madhusudan.C.S <madhusudancs@gmail.com>
parents:
diff changeset
    80
server for the first time. There are also links to recover forgotten
13280334ca2b Adding some sections on getting started with Sage notebook.
Madhusudan.C.S <madhusudancs@gmail.com>
parents:
diff changeset
    81
password and to create new accounts.
13280334ca2b Adding some sections on getting started with Sage notebook.
Madhusudan.C.S <madhusudancs@gmail.com>
parents:
diff changeset
    82
13280334ca2b Adding some sections on getting started with Sage notebook.
Madhusudan.C.S <madhusudancs@gmail.com>
parents:
diff changeset
    83
{{{ If you are logged in tell that you are logged in, log out and show
13280334ca2b Adding some sections on getting started with Sage notebook.
Madhusudan.C.S <madhusudancs@gmail.com>
parents:
diff changeset
    84
what is said above for the login page }}}
13280334ca2b Adding some sections on getting started with Sage notebook.
Madhusudan.C.S <madhusudancs@gmail.com>
parents:
diff changeset
    85
13280334ca2b Adding some sections on getting started with Sage notebook.
Madhusudan.C.S <madhusudancs@gmail.com>
parents:
diff changeset
    86
Once we are logged in with the admin account we can see the notebook
13280334ca2b Adding some sections on getting started with Sage notebook.
Madhusudan.C.S <madhusudancs@gmail.com>
parents:
diff changeset
    87
admin page. A notebook can contain a collection of Sage Notebook
13280334ca2b Adding some sections on getting started with Sage notebook.
Madhusudan.C.S <madhusudancs@gmail.com>
parents:
diff changeset
    88
worksheets. Worksheets are basically the working area. This is where
13280334ca2b Adding some sections on getting started with Sage notebook.
Madhusudan.C.S <madhusudancs@gmail.com>
parents:
diff changeset
    89
we enter all the Sage commands on the notebook.
13280334ca2b Adding some sections on getting started with Sage notebook.
Madhusudan.C.S <madhusudancs@gmail.com>
parents:
diff changeset
    90
13280334ca2b Adding some sections on getting started with Sage notebook.
Madhusudan.C.S <madhusudancs@gmail.com>
parents:
diff changeset
    91
The admin page lists all the worksheets created. On the topmost part
13280334ca2b Adding some sections on getting started with Sage notebook.
Madhusudan.C.S <madhusudancs@gmail.com>
parents:
diff changeset
    92
of this page we have the links to various pages. The home link takes
13280334ca2b Adding some sections on getting started with Sage notebook.
Madhusudan.C.S <madhusudancs@gmail.com>
parents:
diff changeset
    93
to the admin home page. The published link takes us the page which
13280334ca2b Adding some sections on getting started with Sage notebook.
Madhusudan.C.S <madhusudancs@gmail.com>
parents:
diff changeset
    94
lists all the published worksheets.
13280334ca2b Adding some sections on getting started with Sage notebook.
Madhusudan.C.S <madhusudancs@gmail.com>
parents:
diff changeset
    95
13280334ca2b Adding some sections on getting started with Sage notebook.
Madhusudan.C.S <madhusudancs@gmail.com>
parents:
diff changeset
    96
13280334ca2b Adding some sections on getting started with Sage notebook.
Madhusudan.C.S <madhusudancs@gmail.com>
parents:
diff changeset
    97
13280334ca2b Adding some sections on getting started with Sage notebook.
Madhusudan.C.S <madhusudancs@gmail.com>
parents:
diff changeset
    98
13280334ca2b Adding some sections on getting started with Sage notebook.
Madhusudan.C.S <madhusudancs@gmail.com>
parents:
diff changeset
    99
This brings us to the end of the session on using Sage notebook. In
13280334ca2b Adding some sections on getting started with Sage notebook.
Madhusudan.C.S <madhusudancs@gmail.com>
parents:
diff changeset
   100
this tutorial session we learnt
13280334ca2b Adding some sections on getting started with Sage notebook.
Madhusudan.C.S <madhusudancs@gmail.com>
parents:
diff changeset
   101
13280334ca2b Adding some sections on getting started with Sage notebook.
Madhusudan.C.S <madhusudancs@gmail.com>
parents:
diff changeset
   102
  *
13280334ca2b Adding some sections on getting started with Sage notebook.
Madhusudan.C.S <madhusudancs@gmail.com>
parents:
diff changeset
   103
13280334ca2b Adding some sections on getting started with Sage notebook.
Madhusudan.C.S <madhusudancs@gmail.com>
parents:
diff changeset
   104
{{{ Show the "sponsored by FOSSEE" slide }}}
13280334ca2b Adding some sections on getting started with Sage notebook.
Madhusudan.C.S <madhusudancs@gmail.com>
parents:
diff changeset
   105
13280334ca2b Adding some sections on getting started with Sage notebook.
Madhusudan.C.S <madhusudancs@gmail.com>
parents:
diff changeset
   106
This tutorial was created as a part of FOSSEE project, NME ICT, MHRD India
13280334ca2b Adding some sections on getting started with Sage notebook.
Madhusudan.C.S <madhusudancs@gmail.com>
parents:
diff changeset
   107
13280334ca2b Adding some sections on getting started with Sage notebook.
Madhusudan.C.S <madhusudancs@gmail.com>
parents:
diff changeset
   108
Hope you have enjoyed and found it useful.
13280334ca2b Adding some sections on getting started with Sage notebook.
Madhusudan.C.S <madhusudancs@gmail.com>
parents:
diff changeset
   109
Thankyou
13280334ca2b Adding some sections on getting started with Sage notebook.
Madhusudan.C.S <madhusudancs@gmail.com>
parents:
diff changeset
   110
 
13280334ca2b Adding some sections on getting started with Sage notebook.
Madhusudan.C.S <madhusudancs@gmail.com>
parents:
diff changeset
   111
.. Author              : Madhu
13280334ca2b Adding some sections on getting started with Sage notebook.
Madhusudan.C.S <madhusudancs@gmail.com>
parents:
diff changeset
   112
   Internal Reviewer 1 :         [potential reviewer: Anoop]
13280334ca2b Adding some sections on getting started with Sage notebook.
Madhusudan.C.S <madhusudancs@gmail.com>
parents:
diff changeset
   113
   Internal Reviewer 2 :         [potential reviewer: Puneeth]
13280334ca2b Adding some sections on getting started with Sage notebook.
Madhusudan.C.S <madhusudancs@gmail.com>
parents:
diff changeset
   114
   External Reviewer   :
13280334ca2b Adding some sections on getting started with Sage notebook.
Madhusudan.C.S <madhusudancs@gmail.com>
parents:
diff changeset
   115