Project Jupyter is a non-profit, open-source, community-driven organization that oversees the development of a software ecosystem for interactive scientific coding, learning, and discovery. Project Jupyter grew out of the IPython project started by Fernando Pérez as a graduate student in physics at the University of Colorado Boulder.
In CSDMS Ivy, we'll use three tools from the Project Jupyter ecosystem: JupyterHub, JupyterLab, and Jupyter Notebook.
A JupyterHub is a server system that allows multiple users access to a computational resource, where each user can run Jupyter Notebook and other software in their own workspace. A JupyterHub can be installed in the cloud, on a server, or locally.
Through the NSF-funded OpenEarthscape project, CSDMS provides a JupyterHub where Ivy course material can be viewed and run. Click this button:
to open the lessons directly on the EarthscapeHub lab instance!
Note: The EarthscapeHub lab instance is password-protected. Please contact your instructor about obtaining a login, or visit this CSDMS wiki page for more information.
JupyterLab is a browser-based interactive development environment. It provides tools for writing code and creating notebooks, including:
- a file browser,
- launchers for notebooks, data files, and images,
- terminal, text editor, and code console applications, and
- keyboard shortcuts to speed your work.
JupyterLab is the default user interface for JupyterHub. Like JupyterHub, JupyterLab can be installed in the cloud, on a server, or locally.
Take a few minutes to familiarize yourself with the JupyterLab interface on EarthscapeHub.
A Jupyter Notebook is an interactive document for writing, explaining, and running code, and for communicating results.
Notebooks are live documents, with the ability to display tabular data and graphics, as well as interactive displays with widgets. A notebook is made of cells. Each cell can hold code, formatted text (using Markdown), equations, or visualizations.
To get a sense of their popularity, by one estimate, there are currently over 7.5 million notebooks hosted on GitHub. The estimate is presented, of course, in a notebook.
The majority of the CSDMS Ivy course material is built as notebooks.
- Project Jupyter home
- JupyterHub documentation
- JupyterLab documentation and an entertaining demonstration on YouTube
- Jupyter Notebook documentation
- The first section of the Software Carpentry Plotting and Programming in Python lesson has a great section on JupyterLab and Jupyter Notebook
- A collection of notable Jupyter Notebooks and a comprehensive tutorial