Jupyter at JSC

Jupyter is an interactive computational environment, in which you can combine code execution, rich text, mathematics, plots and rich media in a document called Jupyter Notebook. Jupyter Notebooks are for creating reproducible computational narratives.

The Jupyter Notebook is based on a set of open standards for interactive computing. Think HTML and CSS for interactive computing on the web. These open standards can be leveraged by third party developers to build customized applications with embedded interactive computing.

• Language of choice
  The Notebook has support for over 40 programming languages, including Python, R, Julia, and Scala.

• Share notebooks
  Notebooks can be shared with others using email, Dropbox, GitHub and the Jupyter Notebook Viewer.

• Interactive output
  Your code can produce rich, interactive output: HTML, images, videos, LaTeX, and custom MIME types.

• Big data integration
  Leverage big data tools, such as Apache Spark, from Python, R and Scala. Explore that same data with pandas, scikit-learn, ggplot2, TensorFlow.

JupyterLab

JupyterLab is the advanced interactive development environment for working with notebooks, code and data and has full support for Jupyter Notebooks.
But additionally, JupyterLab enables you to use

• text editors, terminals
• data file viewers
• and other custom components

side by side with Jupyter Notebooks in a tabbed work area. JupyterLab provides a high level of integration between notebooks, documents, and activities.

more:

• Jupyter@JSC: (​https://jupyter-jsc.fz-juelich.de)
• Jupyter Homepage (​http://www.jupyter.org)
• Jupyter Blog (​http://blog.jupyter.org)

• Get inspired and check these example Jupyter notebooks:
  • Jupyter Notebook Gallery (​https://github.com/jupyter/jupyter/wiki/A-gallery-of-interesting-Jupyter-Notebooks)

• JupyterLab
  • Introduction: ​https://blog.jupyter.org/jupyterlab-is-ready-for-users-5a6f039b8906
    
  • Overview: ​http://jupyterlab.readthedocs.io/en/stable/getting_started/overview.html
    
  • Interface: ​http://jupyterlab.readthedocs.io/en/stable/user/interface.html

---

Ok, what do I have to do?

Jupyter or JupyterLab (Interactive Supercomputing at JSC) apply for a JSC Web Service Account ​->HERE<- sign in with your JSC Web Service Account to Jupyter4JSC ​->HERE<- accept the usage and data protection aggreement ... ... and you are ready to start Jupyter. Here you can deside on which cluster you want to start Jupyter if you want to run it on login or compute nodes and on how many. if you want to run the classical Jupyter or deside for the new JupyterLab (which we recomment) ................................................................................................................................................................................... ​==> START with Jupyter/JupyterLab at JSC <==

---

How to use your own special software through in a Jupyter-Kernel

In general the Jupyter Kernel live in the system environment, which is loaded for Jupyter itself. This might not suite your needs and you want to switch to a different software stage or want to load additional software modules. In that case you need to set up your own specialized Jupyter kernel. This can be done in a few steps:

---

Developing Extensions for JupyterLab

JupyterLab is built on top of an extension system that enables you to customize and enhance JupyterLab by installing additional extensions.
To start developing a JupyterLab extension, see

• the JupyterLab Extension System ​http://jupyterlab.readthedocs.io/en/stable/user/extensions.htm
• the JupyterLab Extension Developer Guide (​http://jupyterlab.readthedocs.io/en/stable/developer/extension_dev.html)
• the TypeScript (​https://github.com/jupyterlab/extension-cookiecutter-ts)
• JavaScript extension templates (​https://github.com/jupyterlab/extension-cookiecutter-js)

JupyterLab use modern JavaScript technologies such as

• PhosphorJS, ​https://phosphorjs.github.io , for building extensible, high-performance, desktop-style web applications
• TypeScript, ​https://www.typescriptlang.org , a typed superset of JavaScript, that compiles to plain JavaScript
• React, ​https://reactjs.org , a JavaScript library for building user interfaces
• Lerna, ​https://lernajs.io , optimizes the workflow around managing multi-package repositories with git and npm.
• Yarn, ​https://yarnpkg.com , Yarn is a package manager for your code.
• webpack, ​https://webpack.js.org , static module bundler for modern JavaScript applications

Attention:
JupyterLab extensions are written partly in TypeScript (file extension *.ts). These files are compiled to JavaScript with the TypeScript compiler tsc. Therefore, if you change a *.ts file you need to rebuild the JavaScript file. On installation this is done through the file package.json, which triggers tsc. tsc will search for the file tsconfig.json in the current directory and build depending on the configuration there. To rebuild your *.ts files, just call tsc in the directory with tsconfig.json.

---

General Links

Jupyter@JSC: ​https://jupyter-jsc.fz-juelich.de
Jupyter Homepage: ​http://www.jupyter.org
Jupyter Blog: ​http://blog.jupyter.org
Jupyter Notebook Gallery: ​https://github.com/jupyter/jupyter/wiki/A-gallery-of-interesting-Jupyter-Notebooks

---

any feedback welcomed - h.zilken@…, goebbert@…