This repository is used as material for the following training session:
https://indico.egi.eu/indico/event/3973/session/47/?slotId=0#20181010
The training environment for the Notebooks is available at https://training.notebooks.egi.eu To log in just:
- Go to https://training.notebooks.egi.eu
- Start the authentication process by clicking on Sign in with EGI Check-in button
- Select the Identity Provider you belong to from the discovery page (as this is using EGI Check-in development, some of the Identity Providers may not be completely supported, so it's recommended to use social identities (e.g. Google, Facebook, ORCID)
- You will see the JupyterLab interface once your personal notebook is started
Click on the Notebook > Python 3 icon to launch your notebook with Python 3
kernel. When you create this notebook, a new tab will be presented with a
notebook named Untitled.ipynb
. You can easily rename it by right-clicking on
the current name.
The notebook consists of a sequence of cells. A cell is a multiline text input
field, and its contents can be executed by using Shift-Enter
, or by clicking
either the “Play” button in the toolbar, or Cell -> Run in the menu bar.
The execution behaviour of a cell is determined by the cell’s type.
There are three types of cells: cells, markdown, and raw cells. Every cell starts off being a code cell, but its type can be changed by using a drop-down on the toolbar (which will be “Code”, initially).
A code cell allows you to edit and write new code, with full syntax highlighting and tab completion. The programming language you use depends on the kernel.
When a code cell is executed, its content is sent to the kernel associated with the notebook. The results that are returned from this computation are then displayed in the notebook as the cell’s output. The output is not limited to text, with many other possible forms of output are also possible, including figures and HTML tables.
You can document the computational process in a literate way, alternating descriptive text with code, using rich text. This is accomplished by marking up text with the Markdown language. The corresponding cells are called Markdown cells. The Markdown language provides a simple way to perform this text markup, that is, to specify which parts of the text should be emphasized (italics), bold, form lists, etc.
If you want to provide structure for your document, you can also use markdown
headings. Markdown headings consist of 1 to 6 hash #
signs followed by a
space and the title of your section. The markdown heading will be converted
to a clickable link for a section of the notebook. It is also used as a hint
when exporting to other document formats, like PDF.
When a Markdown cell is executed, the Markdown code is converted into the corresponding formatted rich text. Markdown allows arbitrary HTML code for formatting.
Raw cells provide a place in which you can write output directly. Raw cells are not evaluated by the notebook.
All actions in the notebook can be performed with the mouse, but keyboard shortcuts are also available for the most common ones. These are some of the most common:
Shift-Enter
: run cell. Execute the current cell, show any output, and jump to the next cell below. IfShift-Enter
is invoked on the last cell, it creates a new cell below. This is equivalent to clicking the Cell -> Run menu item, or the Play button in the toolbar.Esc
: Command mode. In command mode, you can navigate around the notebook using keyboard shortcuts.Enter
: Edit mode. In edit mode, you can edit text in cells.
- 00-first-notebook.ipynb a very basic notebook to get started
- 01-get-data-and-plot.ipynb Getting data and doing a simple plot
- 02-wind-nowcast.ipynb Notebook that download GFS now- and forecast data from NOAA's GrADS Data Server and plots wind speed and directional vectors on a map for a timestamp closest to the current local time
- 03-customizing.ipynb and Dockerfile installing new libraries and creating custom kernels
- 04-check-in.ipynb Get information about yourself in Check-in