Skip to content

Latest commit

 

History

History
72 lines (45 loc) · 2.25 KB

README.md

File metadata and controls

72 lines (45 loc) · 2.25 KB
Raw

Make your code reproducible by anyone, anywhere

In this section we demonstrate how to host and share Jupyter Notebooks using the Mybinder.org cloud infrastructure. Binder enables users to run Jupyter Notebook in a web-browser without any software installation. It is a platform to support reproducible research.

  • Binder 2.0 blog post

  • Binder 2.0 - Reproducible, interactive, sharable environments for science at scale, Project Jupyter, et al. (2018) Proc. of the 17th Python in Science Conf. (SCIPY 2018).

Presentation

Hands-On Excercise

In this excercise we setup links (Binder Badges) to launch Jupyter Notebook and Jupyter Lab on Binder.

Add a binder badge for a specific Jupyter Notebook

  1. Go to Mybinder.org and paste in the URL of your cloned repository
https://github.com/<your-user-name>/reproducible-computational-workflows
  1. Paste in the path to a specific Jupyter Notebook of your choice, e.g.
3-jupyter/3D_visualization.ipynb

  1. Copy the Binder Badge Markdown text snippet from Mybinder.org

  2. Open this README.md file in Jupyter Lab

  3. Paste the text snippet below

your Jupyter Notebook launch badge goes here ...

Add a binder badge for Jupyter Lab

  1. Next, copy and paste the text snippet below and modify the link to launch Jupyter Lab without a specific notebook

your Jupyter Lab launch badge goes here ...

  1. Save this README.md file (File -> Save Markdown File)

  2. Preview this README file (Right Click [Windows], Ctrl+Click [MacOS] -> Show Markdown Preview)

  3. Add the modified README.md file (see)

git add README.md
  1. Commit your changes
git commit -m "added binder badges"
  1. Push your changes to GitHub
git push origin master
  1. In your web browser open
https://github.com/<your-user-name>/reproducible-computational-workflows

  1. Navigate to the 5-binder directory

  2. Click a "Launch Binder" badge

  3. Wait, wait, ... it may take several minutes to build a binder image ... until Jupyter launches.

  4. Run your Notebooks on MyBinder.org