IPython notebook: Difference between revisions

From IIHE Wiki
Jump to navigationJump to search
(Better ordering procedure)
 
Line 1: Line 1:
IPython is an interactive Python environment. Coupled with the "notebook" module, it provides a rich web interface.
IPython is an interactive Python environment. Coupled with the "notebook" module, it provides a rich web interface.
=Set the environment=
IPython notebook is available on the cluster in 2 environments : the custom build and CVMFS.
* To load from the custom build [deprecated] :
<pre>source /software/sources/latestEnvironment.source</pre>
* To load from CVMFS :
See [[IceCube Software Cluster#CVMFS]]


=Launch a notebook=
=Launch a notebook=


first, connect to the cluster.
# Connect to the cluster.
Set the correct environment and launch a notebook to which you will later connect to from your laptop:
# Load an environment :
 
#:IPython notebook is available on the cluster in 2 environments : the custom build and CVMFS.
<pre>
#:* To load from the custom build [deprecated] :
ipython notebook --no-browser --pylab inline</pre>
#:*:<pre>source /software/sources/latestEnvironment.source</pre>
 
#:* To load from CVMFS :
 
#:*:See [[IceCube Software Cluster#CVMFS]]
When launching the notebook, the system will create a dedicated server for you. It will be running on a specific port chosen by the notebook itself.
# Launch a notebook to which you will later connect to from your laptop:
The launcher reports this port in the following way:
#:<pre>ipython notebook --no-browser --pylab inline</pre>
<pre>
#:When launching the notebook, the system will create a dedicated server for you. It will be running on a specific port chosen by the notebook itself.
The IPython Notebook is running at: http://127.0.0.1:8888/
#:The launcher reports this port in the following way:
</pre>
#:<pre>The IPython Notebook is running at: http://127.0.0.1:8888/</pre>
The port number you need it the number coming after the colon (:).
#:*The port number [PORT_NUMBER] you need is the number coming after the colon (:).
 
#:*The m-machine [M-MACHINE] is the machine where you launched the notebook.
Now, open a new terminal on your laptop and create a tunnel to the machine where you instantiated the notebook. Fill in the correct port number in the following command:
# Open a new terminal on your laptop and create a tunnel to the machine where you instantiated the notebook. Fill in the correct port number in the following command:
 
#:<pre>ssh -L PORT_NUMBER:localhost:PORT_NUMBER M-MACHINE.iihe.ac.be</pre>
<pre>ssh -L PORT_NUMBER:localhost:PORT_NUMBER uixx.iihe.ac.be</pre>
# The tunneled notebook is available in your browser by opening the url : http://localhost:PORT_NUMBER
 
The tunnelled notebook is available in your browser by opening the url : http://localhost:PORT_NUMBER


=Links=
=Links=
http://ipython.org/
http://ipython.org/

Latest revision as of 13:32, 5 October 2016

IPython is an interactive Python environment. Coupled with the "notebook" module, it provides a rich web interface.

Launch a notebook

  1. Connect to the cluster.
  2. Load an environment :
    IPython notebook is available on the cluster in 2 environments : the custom build and CVMFS.
    • To load from the custom build [deprecated] :
      source /software/sources/latestEnvironment.source
    • To load from CVMFS :
      See IceCube Software Cluster#CVMFS
  3. Launch a notebook to which you will later connect to from your laptop:
    ipython notebook --no-browser --pylab inline
    When launching the notebook, the system will create a dedicated server for you. It will be running on a specific port chosen by the notebook itself.
    The launcher reports this port in the following way:
    The IPython Notebook is running at: http://127.0.0.1:8888/
    • The port number [PORT_NUMBER] you need is the number coming after the colon (:).
    • The m-machine [M-MACHINE] is the machine where you launched the notebook.
  4. Open a new terminal on your laptop and create a tunnel to the machine where you instantiated the notebook. Fill in the correct port number in the following command:
    ssh -L PORT_NUMBER:localhost:PORT_NUMBER M-MACHINE.iihe.ac.be
  5. The tunneled notebook is available in your browser by opening the url : http://localhost:PORT_NUMBER

Links

http://ipython.org/