You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/using/selecting.md
+40-41Lines changed: 40 additions & 41 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -13,7 +13,7 @@ This section provides details about the first.
13
13
14
14
## Core Stacks
15
15
16
-
The Jupyter team maintains a set of Docker image definitions in the [https://github.com/jupyter/docker-stacks](https://github.com/jupyter/docker-stacks) GitHub
16
+
The Jupyter team maintains a set of Docker image definitions in the [https://github.com/jupyter/docker-stacks](https://github.com/jupyter/docker-stacks) GitHub
17
17
repository. The following sections describe these images including their contents, relationships, and versioning strategy.
18
18
19
19
### jupyter/base-notebook
@@ -43,7 +43,7 @@ repository. The following sections describe these images including their content
43
43
44
44
* Everything in `jupyter/base-notebook`
45
45
*[Pandoc](http://pandoc.org) and [TeX Live](https://www.tug.org/texlive/) for notebook document conversion
46
-
*[git](https://git-scm.com/), [emacs](https://www.gnu.org/software/emacs/), [jed](https://www.jedsoft.org/jed/), [nano](https://www.nano-editor.org/), tzdata, and
46
+
*[git](https://git-scm.com/), [emacs](https://www.gnu.org/software/emacs/), [jed](https://www.jedsoft.org/jed/), [nano](https://www.nano-editor.org/), tzdata, and
47
47
unzip
48
48
49
49
### jupyter/r-notebook
@@ -57,15 +57,15 @@ unzip
57
57
* Everything in `jupyter/minimal-notebook` and its ancestor images
58
58
* The [R](https://www.r-project.org/) interpreter and base environment
59
59
*[IRKernel](https://irkernel.github.io/) to support R code in Jupyter notebooks
60
-
*[tidyverse](https://www.tidyverse.org/) packages, including [ggplot2](http://ggplot2.org/), [dplyr](http://dplyr.tidyverse.org/),
[rcurl](https://cran.r-project.org/web/packages/RCurl/index.html), and [randomforest](https://cran.r-project.org/web/packages/randomForest/randomForest.pdf)
[rcurl](https://cran.r-project.org/web/packages/RCurl/index.html), and [randomforest](https://cran.r-project.org/web/packages/randomForest/randomForest.pdf)
69
69
packages from [conda-forge](https://conda-forge.github.io/feedstocks)
70
70
71
71
### jupyter/scipy-notebook
@@ -77,14 +77,14 @@ packages from [conda-forge](https://conda-forge.github.io/feedstocks)
77
77
`jupyter/scipy-notebook` includes popular packages from the scientific Python ecosystem.
78
78
79
79
* Everything in `jupyter/minimal-notebook` and its ancestor images
[protobuf](https://developers.google.com/protocol-buffers/docs/pythontutorial), and [xlrd](http://www.python-excel.org/) packages
87
-
*[ipywidgets](https://ipywidgets.readthedocs.io/en/stable/) for interactive visualizations in Python notebooks
87
+
*[ipywidgets](https://ipywidgets.readthedocs.io/en/stable/)and [ipympl](https://github.com/matplotlib/jupyter-matplotlib)for interactive visualizations and plots in Python notebooks
88
88
*[Facets](https://github.com/PAIR-code/facets) for visualizing machine learning datasets
89
89
90
90
### jupyter/tensorflow-notebook
@@ -138,41 +138,41 @@ packages from [conda-forge](https://conda-forge.github.io/feedstocks)
138
138
139
139
### Image Relationships
140
140
141
-
The following diagram depicts the build dependency tree of the core images. (i.e., the `FROM` statements in their Dockerfiles). Any given image inherits the
141
+
The following diagram depicts the build dependency tree of the core images. (i.e., the `FROM` statements in their Dockerfiles). Any given image inherits the
142
142
complete content of all ancestor images pointing to it.
Pull requests to the `jupyter/docker-stacks` repository trigger builds of all images on Travis CI. These images are for testing purposes only and are not saved for
149
+
Pull requests to the `jupyter/docker-stacks` repository trigger builds of all images on Travis CI. These images are for testing purposes only and are not saved for
150
150
use. When pull requests merge to master, all images rebuild on Docker Cloud and become available to `docker pull` from Docker Hub.
151
151
152
152
### Versioning
153
153
154
-
The `latest` tag in each Docker Hub repository tracks the master branch `HEAD` reference on GitHub. `latest` is a moving target, by definition, and will have
154
+
The `latest` tag in each Docker Hub repository tracks the master branch `HEAD` reference on GitHub. `latest` is a moving target, by definition, and will have
155
155
backward-incompatible changes regularly.
156
156
157
-
Every image on Docker Hub also receives a 12-character tag which corresponds with the git commit SHA that triggered the image build. You can inspect the state of
158
-
the `jupyter/docker-stacks` repository for that commit to review the definition of the image (e.g., images with tag 7c45ec67c8e7 were built from
157
+
Every image on Docker Hub also receives a 12-character tag which corresponds with the git commit SHA that triggered the image build. You can inspect the state of
158
+
the `jupyter/docker-stacks` repository for that commit to review the definition of the image (e.g., images with tag 7c45ec67c8e7 were built from
You must refer to git-SHA image tags when stability and reproducibility are important in your work. (e.g. `FROM jupyter/scipy-notebook:7c45ec67c8e7`, `docker run
162
-
-it --rm jupyter/scipy-notebook:7c45ec67c8e7`). You should only use `latest` when a one-off container instance is acceptable (e.g., you want to briefly try a new
161
+
You must refer to git-SHA image tags when stability and reproducibility are important in your work. (e.g. `FROM jupyter/scipy-notebook:7c45ec67c8e7`, `docker run
162
+
-it --rm jupyter/scipy-notebook:7c45ec67c8e7`). You should only use `latest` when a one-off container instance is acceptable (e.g., you want to briefly try a new
163
163
library in a notebook).
164
164
165
165
## Community Stacks
166
166
167
-
The core stacks are just a tiny sample of what's possible when combining Jupyter with other technologies. We encourage members of the Jupyter community to create
167
+
The core stacks are just a tiny sample of what's possible when combining Jupyter with other technologies. We encourage members of the Jupyter community to create
168
168
their own stacks based on the core images and link them below.
169
169
170
-
*[csharp-notebook is a community Jupyter Docker Stack image. Try C# in Jupyter Notebooks](https://github.com/tlinnet/csharp-notebook). The image includes more
171
-
than 200 Jupyter Notebooks with example C# code and can readily be tried online via mybinder.org. Click here to launch
170
+
*[csharp-notebook is a community Jupyter Docker Stack image. Try C# in Jupyter Notebooks](https://github.com/tlinnet/csharp-notebook). The image includes more
171
+
than 200 Jupyter Notebooks with example C# code and can readily be tried online via mybinder.org. Click here to launch
*[education-notebook is a community Jupyter Docker Stack image](https://github.com/umsi-mads/education-notebook). The image includes nbgrader and RISE on top of
175
-
the datascience-notebook image. Click here to launch it on
174
+
*[education-notebook is a community Jupyter Docker Stack image](https://github.com/umsi-mads/education-notebook). The image includes nbgrader and RISE on top of
175
+
the datascience-notebook image. Click here to launch it on
@@ -183,27 +183,26 @@ the datascience-notebook image. Click here to launch it on
183
183
184
184
`crosscompass/ihaskell-notebook` is based on [IHaskell](https://github.com/gibiansky/IHaskell). Includes popular packages and example notebooks.
185
185
186
-
Try it on binder: [ is a community Jupyter Docker Stack image with the [sagemath](https://sagemath.org) kernel on top of
194
-
the minimal-notebook image. Click here to launch it on
193
+
*[sage-notebook](https://github.com/sharpTrick/sage-notebook) is a community Jupyter Docker Stack image with the [sagemath](https://sagemath.org) kernel on top of
194
+
the minimal-notebook image. Click here to launch it on
*[GPU-Jupyter](https://github.com/iot-salzburg/gpu-jupyter/): Leverage Jupyter Notebooks with the power of your NVIDIA GPU and perform GPU calculations using
197
+
*[GPU-Jupyter](https://github.com/iot-salzburg/gpu-jupyter/): Leverage Jupyter Notebooks with the power of your NVIDIA GPU and perform GPU calculations using
198
198
Tensorflow and Pytorch in collaborative notebooks.
199
-
This is done by generating a Dockerfile, that consists of the **nvidia/cuda** base image,
200
-
the well-maintained **docker-stacks** that is integrated as submodule
199
+
This is done by generating a Dockerfile, that consists of the **nvidia/cuda** base image,
200
+
the well-maintained **docker-stacks** that is integrated as submodule
201
201
and GPU-able libraries like **Tensorflow**, **Keras** and **PyTorch** on top of it.
202
202
203
-
*[cgspatial-notebook](https://github.com/SCiO-systems/cgspatial-notebook) is a community Jupyter Docker Stack image. The image includes major geospatial Python &
204
-
R libraries on top of the datascience-notebook image. Try it on
203
+
*[cgspatial-notebook](https://github.com/SCiO-systems/cgspatial-notebook) is a community Jupyter Docker Stack image. The image includes major geospatial Python &
204
+
R libraries on top of the datascience-notebook image. Try it on
0 commit comments