nteract / examples

Example nteract notebooks with links to execution on mybinder.org

the interactive computing suite for you

nteract is an open-source organization committed to creating fantastic interactive computing experiences that allow people to collaborate with ease.

We build SDKs, applications, and libraries that help you and your team make the most of interactive (particularly Jupyter) notebooks and REPLs.

To learn more about the nteract open source organization and the rest of our projects, please visit our website.

What's in this repo?

This repo is a monorepo. It contains the code for the nteract core SDK and nteract's desktop and web applications. It also contains the documentation for the SDK and the applications. Here's a quick guide to the contents of the monorepo.

Folder	Description
applications/desktop	Source code for the nteract desktop application. The desktop application is a cross-platform app built using Electron.
applications/jupyter-extension	Source code the nteract Jupyter extension. This extension can be installed alongside Jupyter classic and JupyterLab in your Jupyter deployments or personal Jupyter server.
packages	JavaScript packages that are part of the nteract core SDK.
changelogs	Changelogs for each release of the nteract core SDK and applications.

How do I contribute to this repo?

If you are interested in contributing to nteract, please read the contribution guidelines for information on how to set up your nteract repo for development, how to write tests and validate changes, how to update documentation, and how to submit your code changes for review on GitHub.

How do I use the nteract core SDK?

If you are a developer who wants to build an nteract-based notebook application, check out the following documentation resources for more info.

Link	What's in it?
docs.nteract.io	This page contains our how-to and tutorial style documentation. Get started learning about the nteract core SDK here.
packages.nteract.io	This page contains the API documentation for packages in our core SDK. Bookmark this and use it as a reference when building your nteract-based UI.
components.nteract.io	This page contains the documentation for our suite of composable React components. It contains code samples that you can reference when building your nteract-based UI.

Our documentation is living. We are always making changes and adding more content. If you have feedback about the documentation, please open an issue in this repo. If you are interested in submitting a change to our documentation page, please review the contribution guidelines and submit a pull request.

How do I use the nteract desktop application?

To get started with the nteract desktop app, head over to the nteract homepage to download the application for your operating system.

Once you've download the app, head over to our documentation page for tutorials and guides on using the app for your data analysis and science workflows.

Supporting nteract

nteract is a non-profit open-source organization fiscally sponsored by NumFOCUS. If you are interested in supporting development on nteract, please consider making a recurring donation.

Development on nteract is also supported by the following organizations.

examples's Issues

Usage of Deprecated module plotly.plotly in the Plotly example notebook

nteract Version : 0.28.0
Notebook: python\plotly.ipynb

In the cell demonstrating the advanced scatter plot features using the Life expectancy vs Per Capita GDP, the notebook is using the old deprecated module plotly.plotly and throws an error.

---------------------------------------------------------------------------
ImportError                               Traceback (most recent call last)
C:\Users\USERNAME\AppData\Local\Temp/ipykernel_21460/3045308087.py in <module>
----> 1 import plotly.plotly as py
      2 import plotly.graph_objs as go
      3 
      4 import pandas as pd
      5 import math

C:\Python39\lib\site-packages\plotly\plotly\__init__.py in <module>
      2 from _plotly_future_ import _chart_studio_error
      3 
----> 4 _chart_studio_error("plotly")

C:\Python39\lib\site-packages\_plotly_future_\__init__.py in _chart_studio_error(submodule)
     41 
     42 def _chart_studio_error(submodule):
---> 43     raise ImportError(
     44         """
     45 The plotly.{submodule} module is deprecated,

ImportError: 
The plotly.plotly module is deprecated,
please install the chart-studio package and use the
chart_studio.plotly module instead.

If installed chart-studio and changed to the first line to import chart_studio.plotly as py it works fine.

It would be better to change the module to the newer and working chart-studio.

Example links 404

Hi folks – awesome project (and we're exploring using it to replace the Jupyter notebook interfaces in our microbial genomics platform)!

I wanted to flag that the example links all seem to 404 on Binder (as of 1/21/19). After clicking about the view a bit, I can get to a version that'll render in Binder, but it's doing so in a vanilla Jupyter notebook.

Didn't have a chance to dig in much further, but hopefully it's either a temporary issue or a simple URL change. 🤞

Add Julia example notebook

I'd like to add a Julia example notebook, like the examples for R, Python and Node that are accessible via the menu. If someone can point me to the place where I would add a Julia item to the menu and then also where I should add the actual notebook file, I'll open a PR.

Update README with latest examples

See #8

Create training notebooks

People seem to enjoy our example notebooks (they also make demoing easy!). I'd like for us to have some organized sections specific to each language and a basic intro notebook:

• Welcome to nteract!
• Python
  • Pandas to GeoJSON
  • Integrating your objects with IPython
  • Updating Displays by Name
• JavaScript
  • Custom revivers for JSON.parse
  • Integrating your objects with IJavaScript
• R
  • Using ggplot
  • Distributing Analysis with Sparklyr
  • Integrating your objects (?) with IRkernel
  • Yes, it's the iris data set again

In the long run we might have a better indexed grouping of content - for now we have a hierarchical menu that we can curate.

Install IJavascript kernel

The node.js notebook(s) needs the IJavascript kernel installed in our binder image. We need it added to our conda config. 😄

Broken Altair notebook with Vega-lite v3

Most of the notebook runs but there is a message at the end saying the visualization could not be rendered.

Binder failed to build

I just tried building Binder and it gave this error on build:

just FYI!

Resolve issue in geojson notebook

#28 (review)