Getting started with Jupyter on Kyso

#Getting-started-with-Jupyter-on-Kyso

This quick guide will show you how to publish a study to Kyso, how to read some data and do basic visualisations using Matplotlib and Bokeh, and how to document your work using Markdown.

Feel free to edit this notebook, or delete it and make your own!

On Kyso you can also:

Publishing a study to Kyso

#Publishing-a-study-to-Kyso

Publishing your work to Kyso lets you share it with the world, send to collegues or save it for later.

To Publish click on the Kyso button in the toolbar and hit "Publish to Kyso"

Loading output library...

Plotting

#Plotting

Take a look at the following posts that are meant as beginner guides for some of the most popular plotting libraries in python:

Personally, bokeh is my favourite!

But here are some basic plots of simple python arrays in each of the libraries above that you can start using to beautiful visualizations on Kyso:

Plotly

#Plotly
Loading output library...
Loading output library...

Bokeh

#Bokeh
Loading output library...
Loading output library...
Loading output library...
Loading output library...

Matplotlib

#Matplotlib
Loading output library...

Matplotlib using Seaborn

#Matplotlib-using-Seaborn
Loading output library...
Loading output library...

Markdown

#Markdown

Use hashtags followed by a blank space for notebook titles and section headings.

# Title (H1)

## Major Headings (H2)

### Subheadings (H3)

#### 4th Level Subheadings (H4)

And so on..

You can wrap markdown in _ _ or * * to make italic or __ __ & ** ** for bold.

Mathematical Equations

#Mathematical-Equations

Courtesy of MathJax, you can include mathematical expressions both inline and centered:

You can wrap your equation in dollar signs, as follows:

@@0@@

@@1@@

Or you can also wrap your equations as shown below, which will align everything centre.

\begin{align}

\dot{x} & = \sigma(y-x) \\

\dot{y} & = \rho x - y - xz \\

\dot{z} & = -\beta z + xy

\end{align}

@@2@@

Lists

#Lists

Use the dash sign ( - ) with two spaces after it or a space, a dash, and a space ( - ), to create a circular bullet. To create a sub bullet, use a tab followed by a dash and two spaces. You can also use an asterisk or a plus sign instead of a dash.

  • Unordered lists can use Asterisks.
  • Dashes.
  • Or the Plus Sign.

For a numbered list start with 1. followed by a space and the numbering will start auotmatically. Start each line with some number and a period, then a space. Tab to indent and get subnumbering.

  • First ordered list item.
  • Another item
  • Unordered sub-list.
  • Actual numbers don't matter, just that it's a number.
  • Ordered sub-list.
  • And another item.

Images

#Images

You can attach image files directly to a notebook only in Markdown cells. Drag and drop your images to the Mardown cell to attach it to the notebook. To add images to other cell types, you can use only graphics that are hosted on the web. Use the following html:

<img src="url.png" alt="Alt text that describes the graphic" title="Title text" />

Alternatively, you can use IPython's display library, which renders images, gifs and videos. Import with the following command:

from IPython.display import Image, HTML, display

You can then embed images and gifs with:

Image(filename='<file_name>.png')

Not exactly executed as markdown, but there is another way to embed videos in the notebook: The following cell loads a local file , encodes the raw video as base64 for http transport, and uses the HTML video tag to load it.

1
2
3
4
5
6
video = io.open('file_name.mp4', 'r+b').read()
encoded = base64.b64encode(video)

HTML(data='''<video alt="test" controls>
                <source src="data:video/mp4;base64,{0}" type="video/mp4" />
             </video>'''.format(encoded.decode('ascii')))             

Linking

#Linking

This is an inline style link. [Go to Kyso](https://kyso.io) Go to Kyso

URLs on their own and URLs in angle brackets will automatically get turned into links.

https://kyso.io

If you want to give your readers an extra about the link that they're about to follow you can set a link title:

[Kyso](https://kyso.io/ "Kyso Notebooks Look Awesome")

Kyso

Hover over the link to reveal the title.

Tables

#Tables

Because Markdown is a superset of HTML, you can even design HTML tables:

1
2
3
4
5
| Header 1 | Header 2 |
|----------|----------|
|R1, Cell 1|R1, Cell 2|
|R2, Cell 1|R2, Cell 2|
|R3, Cell 1|R3, Cell 2|
Header 1Header 2
R1, Cell 1R1, Cell 2
R2, Cell 1R2, Cell 2
R3, Cell 1R3, Cell 2