Skip to content
This repository has been archived by the owner. It is now read-only.
example Iodide notebooks
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
data added volumetric mri vis example notebook + data Jun 12, 2018
README.md
accessing-webcam.html Update master -> stable Aug 9, 2018
brownian-motion.html Update master -> stable Aug 9, 2018
eviction-notices-sf.html Update master -> stable Aug 9, 2018
gym-crowdedness.html
hipster-band-finder.html
introduction-to-javascript-for-python-programmers.html
introduction-to-the-dom-and-its-manipulation.html
lorenz-attractor-pres.html
lorenz-attractor.html Update master -> stable Aug 9, 2018
music-reviews.csv Add hipster band finder May 10, 2018
output-handling.html Update master -> stable Aug 9, 2018
python.html Simplify example Jun 13, 2018
visualize-sorting-algorithms.html Update master -> stable Aug 9, 2018
volumetric.html
what-a-web-notebook-looks-like.html Update master -> stable Aug 9, 2018
world-happiness-report-2018.html

README.md

Note: this repository has been archived. Going forward, we'll be collecting examples and demos at the Iodide server instance hosted at iodide.io


iodide-examples

Start here:

What a web notebook looks like

Then try these featured notebooks:

Be sure to check out these two examples, which feature Python running entirely in the browser, allowing portable and reproducible data science using Python without having to install anything!

Please let us know if you spot any errors! (An issue is great; A PR is ideal!)

You can load an of the other notebooks in the repo by loading the url https://iodide.io/iodide-examples/{NOTEBOOK_NAME}, but be aware that not all of them have recieved the same level of attention and some may be a bit rough.

Contributing

Creating a demo and/or documentation notebooks is the best way to begin contributing to Iodide!

Contributions are very much desired -- as you can see, we've been focusing so intently on building Iodide itself that we haven't yet created nearly enough high quality demo notebooks. But we really need more notebooks that help us tell the story of what Iodide can do and how it works.

You can get started by visiting https://iodide.io/stable/ -- from there, you can begin working on a notebook, and export it to your local machine when you're happy with it.

When you have something you want to share, submit a PR to this repo. Before submitting a PR, please ensure that the resource links to the CSS and JS files in your exported notebooks use the URI https://iodide.io/stable/iodide.stable.*. (Note that if you started working from the link above, you shouldn't have to do anything.

Please be aware that you contibutions to this repo will be open-source -- other folks may propose changes to clarify, clean-up, or enhance your notebooks.

Suggestions for top-notch notebooks

Iodide is intended to be a low-friction way to communicate complex ideas that require computation, visualization, and/or interaction in order to be explained fully. High-quality notebooks will focus on this communication dimension, and will be designed to explain an idea to a reader. A literate programming style is strongly encouraged -- you should aim to have a narrative arc, and to tell a story to your reader; write prose in addition to code.

Please test your notebooks on Firefox and Chrome.

Inspiration

"Data journalism" provides some of the very best sources of inspiration. Take a look at sites like FiveThirtyEight, or the mix of visualization and explanation in things like this interactive piece from the New York Times.

Of course, Iodide is directly inspired by Jupyter, so it's worth checking out nbviewer as another source of examples.

You can’t perform that action at this time.